04 · Claude Code 接入 Freecode#
Claude Code 使用 Anthropic Messages 接口。配置 Freecode 时填写站点根地址，不加 /v1。
1. 安装#
按 Claude Code 官方安装指南 安装当前版本。安装后检查：
claude --version
已有 Node.js 环境、需要使用 npm 安装方式的用户，也可选择：
npm install -g @anthropic-ai/claude-code
官方优先推荐原生安装方式，具体要求以官方指南为准。
2. 配置 settings.json#
配置文件位置：
| 系统 | 路径 |
|---|---|
| macOS / Linux / WSL | ~/.claude/settings.json |
| Windows | %USERPROFILE%\.claude\settings.json |
文件存在时合并 env 中的相关项，保留原有权限、插件等其他设置。以下配置可直接作为新文件模板：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.freecode.cc",
"ANTHROPIC_AUTH_TOKEN": "sk-your-freecode-api-key",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}
替换密钥，并确认其分组可以使用配置的各个模型。主会话之外，Claude Code 也可能调用其他槽位执行后台任务，因此不要给槽位填写该密钥无权使用的模型。
ANTHROPIC_MODEL 是主模型；ANTHROPIC_DEFAULT_*_MODEL 控制相关模型别名。不要把 Base URL 改成 /v1/messages，客户端会自己拼接路径。
3. 可选：先在当前终端验证#
不修改配置文件时，可以在 macOS / Linux / WSL 当前终端设置：
export ANTHROPIC_BASE_URL="https://api.freecode.cc"
export ANTHROPIC_AUTH_TOKEN="sk-your-freecode-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
claude
PowerShell：
$env:ANTHROPIC_BASE_URL = "https://api.freecode.cc"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-freecode-api-key"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-6"
claude
如果原来使用其他服务，检查终端中是否还有旧的 Anthropic 认证或地址变量。使用一种明确的配置来源，并在新会话中通过 /status 确认最终配置。
4. 验证#
在项目目录运行 claude，输入“用一句话说明当前项目的用途”。收到正常回复后打开 使用日志，核对模型、分组和费用。
/status 用于检查配置；只有实际回复和日志记录才能证明本次模型调用成功。也可以使用 CC Switch 管理配置。
常见问题#
- 401：检查完整密钥、有效期、额度，以及是否仍在使用旧服务的认证变量。
- 404：Base URL 应为
https://api.freecode.cc，检查是否重复了/v1。 - 主会话可用，后台任务失败：检查 Haiku / Sonnet / Opus 槽位对应的模型权限。
- 切换后仍走旧服务：重新打开终端与 CLI，核对 CC Switch 当前供应商。
更多排查见 常见问题。