Claude Code 接入指南

适用角色：开发者 更新日期：2026-07-15

Claude Code 是 Anthropic 推出的 CLI 编程 Agent，可以在终端中完成代码编写、调试、重构等任务。通过修改环境变量，可以让 Claude Code 的请求指向平台 API。

前提条件

• 已安装 Claude Code（npm install -g @anthropic-ai/claude-code）
• 已在平台控制台创建 API Key
• 已确认 Base URL（在控制台「API 密钥」页查看）

配置方法

Claude Code 通过三个环境变量控制 API 连接：

方法一：通过 settings.json 配置（推荐）

编辑 ~/.claude/settings.json（Windows 路径：C:\Users\<用户名>\.claude\settings.json），写入以下内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "YOUR_API_BASE_URL",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

保存后重启 Claude Code 即可生效。这种方式的好处是配置持久化，不需要每次打开终端都重新设置。

方法二：通过 Shell 环境变量

在 ~/.zshrc（macOS）或 ~/.bashrc（Linux）中添加：

export ANTHROPIC_BASE_URL="YOUR_API_BASE_URL"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

保存后执行 source ~/.zshrc 使配置生效。

Windows PowerShell：

$env:ANTHROPIC_BASE_URL="YOUR_API_BASE_URL"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

方法三：临时使用（单次会话）

在终端中直接设置，仅当前会话有效：

ANTHROPIC_BASE_URL="YOUR_API_BASE_URL" ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" claude

指定默认模型（可选）

如果你想让 Claude Code 默认使用平台上的特定模型，可以额外设置模型相关变量：

{
  "env": {
    "ANTHROPIC_BASE_URL": "YOUR_API_BASE_URL",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-3-5"
  }
}

将 ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL 都设置好，可以避免 Claude Code 的后台任务（如上下文摘要）在不可用的默认模型上报错。

验证配置

检查环境变量是否生效

# macOS / Linux
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
 
# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

启动 Claude Code 测试

进入任意项目目录，运行 claude，发送一条简单消息（如"你好"），确认能正常收到回复。

如果收到回复，说明配置成功。如果报错，检查以下几点：

• Base URL 是否正确（注意是否需要带 /v1 或路径后缀，具体以平台提供的地址为准）
• API Key 是否正确、是否有余额
• 网络是否能访问 Base URL（可用 curl 测试连通性）

常见问题

Q：配置了但还是连到 Anthropic 官方怎么办？ A：检查是否有多个地方设置了环境变量（如 .zshrc 和 settings.json 同时存在但值不同）。settings.json 优先级更高。另外确认终端已经重启或重新 source 了配置文件。

Q：Claude Code 的 /model 切换命令还能用吗？ A：能用。切换后 Claude Code 会把新的模型名发给你配置的 Base URL，只要平台支持该模型就能正常调用。

Q：Token 消耗为什么比预期多？ A：Claude Code 是 Agent 模式，每个推理步骤都会重新发送完整上下文。一个复杂任务可能产生数十万 Token 消耗。建议在控制台「使用记录」页关注消费情况。

Q：Windows 上怎么用？ A：方法一（settings.json）在 Windows 上同样适用，路径为 C:\Users\<用户名>\.claude\settings.json。方法二需要在 PowerShell 中用 $env: 语法设置环境变量。