Claude Code 配置

在 Claude Code 中使用平台的模型。Claude Code 使用 Anthropic 接口。

准备工作

API 密钥：在控制台的 API 密钥页新建，把下文配置里的 sk-... 换成你的密钥。
接入地址：https://api.gxcy.com（Anthropic 接口，不带 /v1）。
模型：可以调用的模型见控制台的模型页，下文以 deepseek-flash 为例。

使用 Claude Code 命令行

安装

macOS / Linux / WSL：

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

Windows（PowerShell）：

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

访问不了官方安装脚本时，可以用 npm 安装，需要 Node.js 22 或更新版本：

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

Windows 上不需要 WSL，在 PowerShell 或 CMD 中安装即可。建议同时安装 Git for Windows：Claude Code 用 Git Bash 执行命令，没有安装时改用 PowerShell。

验证安装，输出版本号即安装成功：

claude --version

配置

编辑 settings.json，目录不存在时自行创建：

macOS / Linux：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gxcy.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "deepseek-flash",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

这里的设置会覆盖终端中同名的环境变量。配置了 API 密钥，启动时就不再要求登录官方账号。
ANTHROPIC_MODEL 是默认使用的模型。/model 中的 Fable、Opus、Sonnet、Haiku 几档分别对应其余几个 ANTHROPIC_DEFAULT_*_MODEL，子代理也按档取模型，Haiku 一档还用于会话摘要等后台任务。上面都设成同一个模型；也可以给 Haiku 一档换一个更快的模型。
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 关闭自动更新、错误上报等与调用无关的外部请求，在内网使用时建议保留。

使用

进入项目目录，执行：

claude

首次在项目中启动时会询问是否信任此文件夹，选择信任后继续。启动后执行 /status 可以查看当前的接入地址与模型。

使用 VS Code 插件

在 VS Code 扩展市场搜索并安装 Claude Code for VS Code。

插件启动前会检查登录，这一步读不到 ~/.claude/settings.json 里的密钥。在命令面板中执行 Preferences: Open User Settings (JSON)，打开 VS Code 的用户设置，加入：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.gxcy.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-..." },
    { "name": "ANTHROPIC_MODEL", "value": "deepseek-flash" },
    { "name": "ANTHROPIC_DEFAULT_FABLE_MODEL", "value": "deepseek-flash" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "deepseek-flash" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "deepseek-flash" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "deepseek-flash" }
  ]
}

已按上文配置过命令行时，也可以只加上 "claudeCode.disableLoginPrompt": true 跳过这一步检查，插件沿用命令行的配置。

插件的其他用法见 Claude Code 官方文档 Use Claude Code in VS Code。

常见问题

启动时提示有两个凭据来源

之前登录过官方账号时会出现这个提示。执行 /logout 退出官方账号，只用平台的 API 密钥。

用 npm 安装时提示权限不足

不要用管理员身份或 sudo 安装。改用 nvm 管理 Node.js，或改用上文的官方安装脚本。