Claude Code - VisionCoder 智能体平台

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
Windows PowerShell
Windows CMD

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

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

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

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

配置 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-sonnet-4-6`

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

macOS / Linux
Windows PowerShell
Windows CMD
Windows 图形界面

把下面内容追加到 ~/.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-sonnet-4-6"

立即生效：

source ~/.zshrc

[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-sonnet-4-6", "User")

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-sonnet-4-6"

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

重新打开终端

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

验证

macOS / Linux
Windows PowerShell
Windows CMD

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL
claude "hello"

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

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 当前开放的 Claude 系列：

模型 ID	何时用
`claude-sonnet-4-6`	日常默认。性价比最高、上下文够用
`claude-opus-4-7`	复杂推理、长重构、需要更强规划时
`claude-haiku-4-5-20251001`	简单任务，最便宜最快
`claude-opus-4-5-20251101`	Opus 上一代，部分用户偏好的稳定档
`claude-sonnet-4-5-20250929`	Sonnet 上一代
`claude-opus-4-6`	Opus 上上代

完整列表实时返回：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-sonnet-4-6",
    "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 来源，不要再弹登录」。

创建文件：

macOS / Linux
Windows PowerShell
Windows CMD

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

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

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"。

故障排查

验证失败

按顺序检查：

终端是否在写完环境变量后完全重新打开
ANTHROPIC_BASE_URL 是不是 https://coder.api.visioncoder.cn（注意是 coder.api.，不是 api.coder.）
ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 是不是你的完整 Key（粘贴时容易丢首尾字符）
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

加群 & 客服

​前提

​第一次安装：5 步

​切换模型

​已经装过：只配 Key

​可选：写入 Claude Code 配置文件

​VS Code 插件出现登录提示

​跳过首次 Onboarding

​故障排查

​相关

​加群 & 客服

前提

第一次安装：5 步

切换模型

已经装过：只配 Key

可选：写入 Claude Code 配置文件

VS Code 插件出现登录提示

跳过首次 Onboarding

故障排查

相关

加群 & 客服