跳转到主要内容

​
安装

按 Claude Code 官方方式完成安装，确认 claude --version 可运行。然后配置以下环境变量。
若当前 Claude Code 版本读取 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 正确后，如仍进入登录流程，可按以下步骤跳过首次引导：
  1. 定位用户主目录下的 .claude.json 文件：
    • macOS / Linux：~/.claude.json
    • Windows：C:\Users\%USERNAME%\.claude.json
  2. 将 hasCompletedOnboarding 字段设置为 true：
  1. 保存文件，然后在终端中重新运行 claude。
如果 .claude.json 已包含其他字段，只添加或修改 hasCompletedOnboarding，不要覆盖整个文件。

​
其他错误

  • 401：不要把 API_KEY 占位符原样写入配置。
  • 400 Incorrect model ID：从实时模型页复制完整模型 ID。
  • CC Switch 与手动配置同时存在：删除冲突的全局 ANTHROPIC_* 变量。