Claude Code

如果你想把 Claude Code 接到 FreeDom API，最简单的理解就是：

把 Claude Code 默认请求地址改成你的 FreeDom API 地址，再填入你的 API Key。

TIP

如果你不想手动配置环境变量，建议优先看 CC Switch 快速接入。它更省事，也更不容易填错。

第一步：安装 Claude Code

先确认你的电脑已经安装 Node.js，然后执行：

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

安装完成后可以检查一下：

claude --version

第二步：填写 FreeDom API 配置

推荐使用下面这组变量：

export ANTHROPIC_BASE_URL="https://api.yonghu.shop"
export ANTHROPIC_AUTH_TOKEN="你的_API_Key"
export ANTHROPIC_API_KEY="你的_API_Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.yonghu.shop"
export ANTHROPIC_AUTH_TOKEN="你的_API_Key"
export ANTHROPIC_API_KEY="你的_API_Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.yonghu.shop"
$env:ANTHROPIC_AUTH_TOKEN="你的_API_Key"
$env:ANTHROPIC_API_KEY="你的_API_Key"
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"
claude

第三步：验证是否成功

进入 Claude Code 后，输入一句最简单的话：

请只回复 ok

如果配置正常，一般会有这些表现：

• Claude Code 能正常启动
• 能返回文本
• 没有 401 / 403 / 404 错误

常见问题

1. 还是连到官方地址

通常是当前终端没有刷新。请关闭终端后重新打开，再执行一次。

2. 提示 401 / 403

一般是下面几种原因：

• API Key 填错
• API Key 失效
• 额度不足
• 当前 Key 没有对应模型权限

3. 某个模型不能用

通常是模型名不一致，或者你的 Key 没开这个模型。

最稳妥的方法：以控制台里实际可见模型为准。

给新用户的建议

如果你只是想尽快用起来，不想自己处理环境变量和终端问题，直接用 CC Switch 快速接入 会更省事。