在 Claude Code 里用 apimodels

三个环境变量,把本地的 Claude Code 指向 apimodels,用你的余额跑 claude-opus-5-5 —— 读写本地文件、跑命令、跨文件重构,全在你自己机器上执行。大约 3 分钟。

需要的配置值

变量	值
ANTHROPIC_BASE_URL	https://api.apimodels.app
ANTHROPIC_AUTH_TOKEN	你的 apimodels API Key(原样填,无需 Bearer 前缀)
ANTHROPIC_MODEL	claude-opus-5-5

重要: ANTHROPIC_BASE_URL 只填到 https://api.apimodels.app —— 不要手动加 /v1/messages,Claude Code 会自动拼上。

密钥两种填法二选一(我们同时支持 Authorization: Bearer 和 x-api-key,所以原始 key 直接填即可):

ANTHROPIC_AUTH_TOKEN = 原始 key(Claude Code 以 Bearer 发送)。推荐。
ANTHROPIC_API_KEY = 原始 key(以 x-api-key 发送)。二者只设一个。

第 1 步:安装 Claude Code

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

装完跑 claude --version 看到版本号即成功。⚠️ 装完后不要用 Anthropic 账号登录 —— 下一步用 apimodels 的凭证接入。

第 2 步:配置凭证(二选一)

方式 A:系统环境变量(推荐)

配一次,之后每个终端会话都自动走 apimodels。

macOS / Linux

# ~/.zshrc  —  Method A (recommended)
echo 'export ANTHROPIC_BASE_URL="https://api.apimodels.app"'   >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk_…your_apimodels_key…"'   >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-opus-5-5"'                >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell)

# PowerShell  —  Method A (recommended)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apimodels.app", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk_…your_apimodels_key…", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-opus-5-5", "User")

改完环境变量后,关掉所有终端窗口再重开(新窗口才会读到变量)。

方式 B:Claude Code 配置文件

只在跑 claude 时生效,不影响系统其它程序 —— 想隔离就用这个。文件路径:macOS ~/.claude/settings.json;Windows C:\Users\<用户名>\.claude\settings.json(没有就新建)。

// ~/.claude/settings.json  —  Method B (per-Claude-Code, isolated)
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apimodels.app",
    "ANTHROPIC_AUTH_TOKEN": "sk_…your_apimodels_key…",
    "ANTHROPIC_MODEL": "claude-opus-5-5"
  }
}

第 3 步:选模型

默认用 claude-opus-5-5(已在上面的 ANTHROPIC_MODEL 里设好)。进入会话后也可以随时输入 /model 切换到其它 claude- 模型(如 claude-sonnet-5-5)。

第 4 步:验证连接

任意项目目录下起一个会话,发条 “Hello” 试试:

cd your-project
claude

✅ 正常回复 → 已接通,可在 apimodels 调用记录里看到用量。
❌ 又提示登录 Anthropic 账号 → 见下方排错第 1 条。

想在装 Claude Code 之前先确认端点和 key 能通,跑这条 curl:

curl -s https://api.apimodels.app/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 16,
    "messages": [{ "role": "user", "content": "Reply with exactly: ok" }]
  }'

编程使用场景:它到底能干什么

Claude Code 是一个在你本机运行的 agentic 编程工具。模型(通过 apimodels 调的 claude-opus-5-5)负责“决定要做什么”,而读写文件、执行命令这些动作由 Claude Code 在你自己的机器上完成 —— 你的代码不经过我们,只有你发给模型的上下文会传输。所以本地文件操作完全可用。

跨文件重构

“把这个模块拆成三个文件并更新所有引用” —— 它会读相关文件、改动、再验证。

定位并修 bug

描述现象,它会搜代码库、定位、改代码,必要时跑测试确认。

写测试 / 跑命令

生成测试、执行 npm test / 构建命令,根据输出迭代。

读代码库回答问题

“鉴权是怎么走的?” —— 它会读多文件后给出带路径的回答。

能用哪些模型(以及 GPT 怎么办)

Claude Code 只说 Anthropic Messages 协议,所以在它里面只能用我们的 claude- 模型(推荐 claude-opus-5-5)。

GPT 模型(如 GPT-6 Sol)走的是 OpenAI Responses 协议,Claude Code 用不了 —— 它们请改用 OpenAI Codex CLI(同样能在本机操作文件),配置见 /docs/codex。

CLI	用哪个模型	本地文件操作
Claude Code	claude-opus-5-5	✅
OpenAI Codex	gpt-6-sol / gpt-6.1-sol	✅
Claude Code + GPT	gpt-6-sol / gpt-6.1-sol	❌ 协议不兼容

排错

症状	原因 / 修法
还是提示登录 Anthropic 账号	环境变量没加载。完全关闭所有终端(含 VSCode / Cursor 内置终端)再重开;装完别用 Anthropic 账号登录。
HTTP 401	key 错或没设。ANTHROPIC_AUTH_TOKEN 填原始 key 即可(我们支持 Bearer 和 x-api-key,不用加 Bearer 前缀)。去控制台核对 key。
model not found / 模型不支持	会话里 /model 切到我们支持的 claude- 模型(如 claude-opus-5-5 / claude-sonnet-5-5)。
想用 GPT 模型但报错	Claude Code 不支持 Responses 协议模型。改用 Codex CLI,见 /docs/codex。
Windows 改了不生效	关闭所有终端(含编辑器内置终端),完全退出这些应用再重开。

想看 Claude Code 实际发出的请求,用 claude --debug 启动看详细日志。

安全提示

API Key 保密,绝不要出现在截图、群聊、代码仓库里。
若把 settings.json 放在项目目录内,把 .claude/settings.json 加进 .gitignore;放在 home 目录(~/.claude/)默认是安全的。
key 一旦泄露,立刻去控制台重置。