手动配置 Claude Code

提示

推荐直接在后台密钥列表点击 使用密钥，复制自动生成的配置；或使用 CC-Switch 一键导入，小白友好！

前置条件

请先创建一个 Claude（Anthropic）分组 的 API Key，见 API 密钥管理。如果你的 Key 是 Antigravity 分组，请看 Antigravity 渠道。

方式一：配置文件（推荐）

1. 确认 Claude Code 已安装

claude --version

如果提示命令不存在，请先安装 Claude Code：

npm i -g @anthropic-ai/claude-code@latest

2. 找到 Claude Code 的配置文件夹

打开终端，根据系统执行下面的命令。目录不存在时先创建目录，再打开。

Windows

CMD 命令行：

if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
start "" "%USERPROFILE%\.claude"

macOS

mkdir -p "$HOME/.claude"
open "$HOME/.claude"

3. 写入 settings.json

手动创建或编辑 settings.json，写入如下内容：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://goodcode.store",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的ApiKey",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

把 ANTHROPIC_AUTH_TOKEN 换成你在后台生成的 Claude 分组 API Key，然后保存文件。

提示

Claude Code 官方支持通过 settings.json 的 env 字段为每次会话注入环境变量。ANTHROPIC_BASE_URL 用来指向 GoodCode 网关，ANTHROPIC_AUTH_TOKEN 是你的 GoodCode API Key。

4. 重启并验证

关闭当前 Claude Code 会话，重新打开终端后运行：

claude

进入交互界面后可以输入 /status 查看当前配置状态，也可以直接发送一句简单问题测试。如果能正常返回内容，说明 Claude Code 已接入 GoodCode。

方式二：环境变量（临时会话）

如果只想在当前终端会话中临时使用：

macOS / Linux

export ANTHROPIC_BASE_URL="https://goodcode.store"
export ANTHROPIC_AUTH_TOKEN="sk-你的ApiKey"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0
claude

Windows CMD

set ANTHROPIC_BASE_URL=https://goodcode.store
set ANTHROPIC_AUTH_TOKEN=sk-你的ApiKey
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
set CLAUDE_CODE_ATTRIBUTION_HEADER=0
claude

PowerShell

$env:ANTHROPIC_BASE_URL="https://goodcode.store"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的ApiKey"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
$env:CLAUDE_CODE_ATTRIBUTION_HEADER=0
claude

相关信息

环境变量只在当前终端会话中生效。如需永久配置，请将其添加到 ~/.bashrc、~/.zshrc 或使用方式一的 settings.json。

VSCode 插件版

VSCode 的 Claude Code 插件同样读取 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json），按方式一配置即可，配置后重启 VSCode 生效。