Claude Code

Claude Code 是 Anthropic 官方的命令行 Agent，专精项目级代码理解、修改、重构。VisionCoder 提供完全兼容 Anthropic Messages API 的端点 —— 不需要改 Claude Code 任何代码，只换 Base URL 和 API Key。

前提

• 已在 API Key 管理 创建 API Key
• 已装 Node.js 18+
• Windows 用户：额外装 Git for Windows

第一次安装：5 步

安装 Claude Code

macOS / Linux

npm install -g @anthropic-ai/claude-code
claude --version

Windows PowerShell

npm install -g @anthropic-ai/claude-code
claude --version

Windows CMD

npm install -g @anthropic-ai/claude-code
claude --version

能看到版本号就说明安装成功。提示找不到 claude 命令？关闭终端、重新打开。

Claude Code 安装成功示例

配置 4 个环境变量

Claude Code 读以下变量来确定走 VisionCoder：

变量名	值
ANTHROPIC_API_KEY	YOUR_API_KEY
ANTHROPIC_AUTH_TOKEN	YOUR_API_KEY
ANTHROPIC_BASE_URL	https://coder.api.visioncoder.cn
ANTHROPIC_MODEL	claude-opus-5

注意

ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 填同一个 Key——新旧版本 Claude Code 读的字段不同，两个都设最稳。

macOS / Linux

把下面内容追加到 ~/.zshrc（或 ~/.bashrc）：

export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://coder.api.visioncoder.cn"
export ANTHROPIC_MODEL="claude-opus-5"

立即生效：

source ~/.zshrc

Windows PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://coder.api.visioncoder.cn", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-opus-5", "User")

Windows CMD

setx ANTHROPIC_API_KEY "YOUR_API_KEY"
setx ANTHROPIC_AUTH_TOKEN "YOUR_API_KEY"
setx ANTHROPIC_BASE_URL "https://coder.api.visioncoder.cn"
setx ANTHROPIC_MODEL "claude-opus-5"

Windows 图形界面

1. 按 Win + R，输入 sysdm.cpl 回车
2. 「高级」→「环境变量」
3. 在「用户变量」里新建上面 4 个变量
4. 保存后关闭所有终端（PowerShell、CMD、VS Code 集成终端）再重新打开

重新打开终端

警告

Windows 用户必做：setx 写入的环境变量对当前 shell 不生效，必须关掉所有终端重开。macOS / Linux 用 source 也行。

验证

macOS / Linux

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL
claude "hello"

Windows PowerShell

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL
claude "hello"

Windows CMD

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%
claude "hello"

Claude 返回内容就是成功。

开始使用

进项目目录启动：

cd my-project
claude

首次会问 Trust This Folder，选信任。

常用斜杠命令：

• /status —— 看当前模型 / API 地址 / 上下文用量
• /model —— 切换模型（详见下方）
• /clear —— 清空当前会话上下文

切换模型

在 Claude Code 内输入 /model，列出 VisionCoder 当前开放的 Anthropic 协议模型。Claude 当前统一使用：

模型 ID	何时用
claude-opus-5	日常编码、复杂推理和长重构

开源 / 国产模型也全部支持 Anthropic 协议，可直接在 Claude Code 中使用：deepseek-v4-pro、deepseek-v4-flash、qwen3.6-35b-a3b、kimi-k2.6、glm-5.1、glm-5.2、minimax-m2.7。

完整列表实时返回：curl https://coder.api.visioncoder.cn/v1/models。

已经装过：只配 Key

claude --version    # 能看到版本号

能跑就跳过安装，从 第 2 步：配置 4 个环境变量 开始。

可选：写入 Claude Code 配置文件

99% 的用户走环境变量就够。极端情况下（管理员限制用户环境变量、CI 容器里、多 Key 切换场景），可以把同样的配置写进 Claude Code 的本地 settings.json 里——Claude Code 启动时直接读，优先级和环境变量平级。

文件位置：

• macOS / Linux：~/.claude/settings.json
• Windows：C:\Users\你的用户名\.claude\settings.json

内容：

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://coder.api.visioncoder.cn",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

两个附加字段说明：

• API_TIMEOUT_MS —— 长上下文 / 推理任务必须调大（默认 60s 不够），3000000 是 50 分钟
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC —— 关闭遥测和非必要外联，部分企业网络下能减少超时

VS Code 插件出现登录提示

新版 Claude Code VS Code 插件偶尔会跳官方登录界面 —— 绕过办法是补一个本地 ~/.claude/config.json，告诉插件「我用的是别的 API Key 来源，不要再弹登录」。

VS Code 插件登录界面示例（出现这个就要补 config.json）

创建文件：

macOS / Linux

mkdir -p ~/.claude
cat > ~/.claude/config.json <<'EOF'
{
  "primaryApiKey": "visionCoder"
}
EOF

Windows PowerShell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
'{"primaryApiKey":"visionCoder"}' | Set-Content "$env:USERPROFILE\.claude\config.json"

Windows CMD

mkdir %USERPROFILE%\.claude
echo {"primaryApiKey":"visionCoder"} > %USERPROFILE%\.claude\config.json

保存后完全重启 VS Code（不只是关终端 —— 关掉整个 VS Code 窗口再开）。

跳过首次 Onboarding

第一次启动 claude 可能卡在欢迎引导（特别是 CI / 容器 / 自动化脚本里）。补一个 .claude.json 标记已完成 onboarding，下次启动直接进会话。

提示

出现 Unable to connect to Anthropic services 这类报错时，补这个文件经常一并解决。

文件位置：

• macOS / Linux：~/.claude.json（注意是用户主目录，不是 ~/.claude/ 目录下）
• Windows：C:\Users\你的用户名\.claude.json

内容：

{
  "installMethod": "unknown",
  "autoUpdates": true,
  "firstStartTime": "[time]",
  "hasCompletedOnboarding": true
}

注意

[time] 可以留字面值，Claude Code 不强校验。也可以填 ISO 时间戳，比如 "2025-01-01T00:00:00Z"。

故障排查

验证失败

按顺序检查：

1. 终端是否在写完环境变量后完全重新打开
2. ANTHROPIC_BASE_URL 是不是 https://coder.api.visioncoder.cn（注意是 coder.api.，不是 api.coder.）
3. ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 是不是你的完整 Key（粘贴时容易丢首尾字符）
4. Key 没创建？去 API Key 管理

报错 "Unable to connect to Anthropic services"

完整报错：

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Claude Code 没读到 ANTHROPIC_BASE_URL，跑去找 api.anthropic.com 了。先按上一条「验证失败」排一遍；还不行就按 跳过首次 Onboarding 那节补 ~/.claude.json。

升级 Claude Code

三个平台都通用：

claude update
claude --version

Claude Code 升级输出示例

相关

• 协议端点：POST /v1/messages ←Claude Code 实际调用的接口
• 模型实时列表：GET /v1/models

加群 & 客服

AI 技术交流群

专属客服