安装
按 Claude Code 官方方式完成安装,确认claude --version 可运行。然后配置以下环境变量。
ANTHROPIC_API_KEY 而非 ANTHROPIC_AUTH_TOKEN,将同一密钥写入该变量。模型必须支持 Anthropic Messages 和工具调用。
持久化配置
macOS/Linux 可将变量写入~/.zshrc 或 ~/.bashrc 后重新加载;Windows 可写入用户环境变量。也可在 ~/.claude/settings.json 的 env 中配置,但不要把包含真实 Key 的文件提交到仓库。
常见问题
提示 Not logged in 或要求登录
如果启动后看到 Not logged in · Please run /login,或进入 Anthropic 登录选项,通常说明 Claude Code 没有读取到可用的便携AI聚合API配置,或首次引导尚未完成。 先检查ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 和 ANTHROPIC_MODEL 是否已在当前终端生效,以及是否被旧的全局环境变量或 CC Switch 配置覆盖。确认 Key、Base URL 和模型 ID 正确后,如仍进入登录流程,可按以下步骤跳过首次引导:
-
定位用户主目录下的
.claude.json文件:- macOS / Linux:
~/.claude.json - Windows:
C:\Users\%USERNAME%\.claude.json
- macOS / Linux:
-
将
hasCompletedOnboarding字段设置为true:
- 保存文件,然后在终端中重新运行
claude。
如果
.claude.json 已包含其他字段,只添加或修改 hasCompletedOnboarding,不要覆盖整个文件。其他错误
401:不要把API_KEY占位符原样写入配置。400 Incorrect model ID:从实时模型页复制完整模型 ID。- CC Switch 与手动配置同时存在:删除冲突的全局
ANTHROPIC_*变量。
