Claude Code 配置

大约 2 分钟

Claude Code 手动配置

本页适用于不依赖 CC-Switch、直接维护 Claude 本地配置文件的场景。

一、配置文件位置

系统	路径
Windows	`%USERPROFILE%\\.claude\\settings.json`
macOS	`~/.claude/settings.json`
Linux	`~/.claude/settings.json`

二、写入基础配置

settings.json 示例：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.yuzhixiaolongxia.com",
    "ANTHROPIC_AUTH_TOKEN": "替换为你的Claude分组令牌",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
  }
}

说明：

ANTHROPIC_BASE_URL：统一入口地址
ANTHROPIC_AUTH_TOKEN：必须使用 Claude 分组令牌

三、令牌与模型建议

令牌来源：

先在控制台创建 Claude 分组令牌：/docs/register/4-token.html

模型建议：

优先使用分组内稳定模型
模型名以控制台或分组说明页为准

四、验证步骤

关闭旧终端，重新打开
执行：

claude

发送一条简短测试问题，能收到正常响应即成功

五、多设备同步建议

推荐把“非敏感配置模板”和“密钥”分开管理：

把 settings.json 模板存到私有仓库（不要提交真实 Key）
API Key 放密码管理器
新设备初始化时仅替换 Key

示例流程：

同步模板文件
登录控制台创建新设备令牌
写入令牌并验证

六、常见错误与处理

现象	原因	处理方式
`401 Unauthorized`	Key 无效或过期	重建令牌并替换
`connection refused`	地址写错或网络异常	检查 `ANTHROPIC_BASE_URL` 和网络
`model not found`	模型不在分组内	切换分组支持模型
配置后无变化	终端未重启	重开终端再测

七、可选配置

若需要在 VS Code 中配合使用，可在同目录创建 config.json：

{
  "primaryApiKey": "预制小龙虾"
}

该配置用于工具识别，实际认证仍以 settings.json 中的令牌为准。

下一步：Codex 配置