HopBase 文档Claude Code
通过一键接入或环境变量将 Claude Code 连接到 HopBase。
Claude Code 是 Anthropic 的官方编程 CLI。首次接入建议使用控制台「一键接入」；需要管理多个供应商时使用 CC Switch；已有固定环境管理流程时再手动配置。
| 方式 | 适合场景 | 会完成什么 |
|---|---|---|
| 一键接入（推荐） | 首次安装或希望快速完成配置 | 安装 Claude Code、备份并写入 ~/.claude/settings.json、验证密钥 |
| CC Switch | 偏好图形界面或需要切换多个供应商 | 导入并切换 Claude Code 供应商配置 |
| 手动配置 | 已有 Claude Code 和环境变量管理流程 | 自行设置 Base URL 与密钥环境变量 |
推荐：控制台一键接入
Windows、macOS 和 Linux 均支持，无需手动编辑环境变量。
复制你系统对应的命令
弹窗选 Claude Code，系统按需切换 macOS / Linux 或 Windows PowerShell，点「生成接入命令」后复制。
贴到终端，按 Enter
macOS 开「终端」，Linux 开任一终端（需已安装 curl），Windows 开「PowerShell」（开始菜单搜索即可）。脚本会自动安装 Claude Code（已装则跳过）、写入密钥配置（原配置自动备份）并验证连接。
看到绿色「接入成功」就完成了
新开一个终端窗口，输入 claude 开始使用。
安全说明：命令使用 15 分钟内有效、只能使用一次的接入令牌，不会在命令中暴露 API 密钥。
脚本把 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 合并写入 ~/.claude/settings.json 的 env（原文件先备份为 settings.json.bak.时间戳）。Claude Code 以这个文件的值为准，在 shell 里设置的同名环境变量不会生效；要换密钥或地址，请改这个文件或重新执行一键接入，不要和手动配置混用。
图形化管理：CC Switch
CC Switch 独立指南按 macOS / Windows / Linux 说明安装、从 HopBase 控制台导入 Claude Code 或 Codex CLI、切换供应商，以及 GLM-5.3 本地路由。
手动配置
临时设置：只在当前终端窗口有效。
export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥
# 然后正常启动
claude永久设置：写入 shell 启动文件，之后新开终端即可使用。
# zsh（macOS 默认）
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc
# bash（Linux 常见；与上面 zsh 二选一）
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc切换模型
在 Claude Code 会话中输入 /model 选择或填入模型 ID；也可以启动时加 --model，或设置环境变量 ANTHROPIC_MODEL（用一键接入时写进 ~/.claude/settings.json 的 env）。只使用当前密钥调 GET /v1/models 返回的 ID。
# 会话中切换（只输入 /model 会列出可选模型）
/model claude-opus-5
# 或启动时指定
claude --model claude-sonnet-5选择分组
以创建密钥时的分组下拉为准。目前公开的 Claude 分组可用模型相同，区别在适用客户端：
| 分组 | 适用 |
|---|---|
| Claude Max (官号满血版) | Claude Code、SDK、编辑器和第三方客户端 |
| Claude Max (官号满血版) - 限时特惠 | 与上一行相同，限时提供 |
| Claude Max （ccmax） | 仅限 Claude Code 客户端；用这把密钥从 SDK、curl、编辑器或第三方客户端调用会失败 |