1. 安装 Claude Code
本地安装
使用 npm 安装
需要 Node.js 18 或更高版本2. 配置 Harogo API
要通过兼容 Anthropic API 的方式来接入 Harogo 的模型服务,需要配置以下环境变量。- 将
ANTHROPIC_BASE_URL设置为https://api.harogo.ai/ - 将
ANTHROPIC_AUTH_TOKEN设置为从 Harogo 平台 获取的 API Key - 将
ANTHROPIC_MODEL设置为 Harogo 中支持的 Claude 模型,例如claude-sonnet-5。
- macOS
- Windows
- 在终端中执行以下命令,查看默认 Shell 类型。
- 根据 Shell 类型设置环境变量,命令如下:
- 在终端中执行下列命令,使环境变量生效。
- 打开一个新的终端,执行下列命令,查看环境变量是否生效。
如果你准备通过 CC Switch 管理 Claude Code,建议不要再额外设置全局
ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL。系统或用户环境变量可能覆盖 CC Switch 写入的 Provider 配置,导致界面里选择了正确 Provider,但 Claude Code 实际仍使用旧 Key 或旧模型。3. 验证配置是否生效
完成环境变量或 CC Switch 配置后,建议先用一次最小请求确认 Key、模型和 Anthropic 兼容接口都可用,再启动长会话。4. 开始使用
完成配置后,进入你的工作目录,在终端运行claude 命令开始使用 Claude Code。
Not logged in · Please run /login,或进入 Anthropic 登录选项,通常说明 Claude Code 没有读取到可用的 Harogo 配置,或首次引导尚未完成。请先确认上一步最小请求可返回 2,并检查 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL 是否被旧的全局环境变量覆盖。确认 Key 可用后,如仍进入登录流程,可按以下步骤跳过首次引导:

- 定位用户主目录下的
.claude.json文件,具体路径如下:- macOS / Linux:
~/.claude.json - Windows:
C:\Users\%USERNAME%\.claude.json
- macOS / Linux:
- 设置
hasCompletedOnboarding字段的值为true
- 保存文件,然后在终端中重新运行
claude。
(可选)更多配置模型的方式
Claude Code 支持以下模型配置方式,按优先级从高到低排列,优先级高的配置会覆盖优先级低的配置。- 对话期间: 执行
/model <模型名称>命令切换模型。适用于临时切换模型。
- 启动 Claude Code 时: 执行
claude --model <模型名称>指定模型。适用于单次会话。
- 设置环境变量:可按任务复杂度配置不同级别的模型,Claude Code 会根据任务类型自动选择合适的模型。适用于全局生效。
ANTHROPIC_DEFAULT_OPUS_MODEL:用于复杂推理、架构设计等高难度任务。ANTHROPIC_DEFAULT_SONNET_MODEL:用于代码编写、功能实现等日常任务。ANTHROPIC_DEFAULT_HAIKU_MODEL:用于语法检查、文件搜索等简单任务。
- 在 settings.json 配置文件中永久设置:在 Claude Code 的用户配置文件(如
~/.claude/settings.json,Windows 为C:\Users\%USERNAME%\.claude\settings.json)或项目级配置中写入模型配置信息,可分别进行用户级或项目级的永久配置。
如何通过 CC Switch 配置?
- 运行 CC Switch,先在左侧选择 Claude Code,再点击「添加供应商」。

- 在预设列表中选择供应商为「自定义配置」。

- 填写供应商名称、API Key、端点「https://api.harogo.ai」等信息。信息填写完整后,点击「添加」即可。

- 返回首页,在供应商列表中选择「harogo」,点击「使用」即可。

Tip: 终端打开 Claude Code后,输入 /status 可查询模型ID,输入/models 可选择配置的其他模型


