Claude Code

Claude Code API 配置

使用 Anthropic 兼容入口接入 Claude Code，覆盖环境变量、项目 settings、模型验证和长上下文注意事项。

由 Claude Agent 技术团队维护 · 发布于 2026-07-14 · 更新于 2026-09-30

环境变量配置

export ANTHROPIC_BASE_URL="https://claudeagent.com.cn"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-opus-5-5"
claude

Claude Code 的基础地址使用站点根域名，不在末尾添加 /v1。

项目级配置

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claudeagent.com.cn",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-5-5"
  }
}

把内容保存到项目的 .claude/settings.json。真实 Key 不应提交到 Git。

选择 Claude Opus 5.5

使用 default 或 kiro pro 分组的 Key，模型名填写 claude-opus-5-5。已启动的 Claude Code 会话可输入 /model claude-opus-5-5 切换。当前模型与分组对应关系见模型列表；客户端内置列表尚未更新时，可直接填写完整模型名。

Windows、macOS 与 Linux

系统	当前终端设置	持久化位置
macOS / Linux	export ANTHROPIC_BASE_URL=...	~/.zshrc 或 ~/.bashrc
Windows PowerShell	$env:ANTHROPIC_BASE_URL=...	用户环境变量或 PowerShell 配置
Windows CMD	set ANTHROPIC_BASE_URL=...	用户环境变量

同一终端还需设置 ANTHROPIC_AUTH_TOKEN。设置后重新打开终端，再运行 claude 验证。

验证顺序

确认分组可用

先查看分组状态页，默认从 default 分组开始。

发送短请求

先让模型回复一个短句，确认鉴权、模型和路由都正常。

再运行长上下文任务

长任务前阅读缓存计费说明，避免把缓存读取误认为完整输入。

常见问题

Base URL 要不要加 /v1？

不要。Claude Code 的 ANTHROPIC_BASE_URL 使用站点根域名。

如何使用 Opus 5.5？

使用 default 或 kiro pro 分组的 Key，设置 ANTHROPIC_MODEL=claude-opus-5-5，或在会话中输入 /model claude-opus-5-5。

模型名怎么确认？

使用控制台或 /v1/models 的实际返回，不依赖旧教程。