跳到主要内容

Claude Code x UniKey 配置教程

Claude Code 可以通过 Anthropic 兼容 Messages API 使用 UniKey。UniKey 中转站基于 NewAPI 搭建，Claude Code 配置应指向 UniKey Base URL：

ANTHROPIC_BASE_URL=https://www.getunikey.ai
ANTHROPIC_AUTH_TOKEN=<你的 UniKey API Key>
ANTHROPIC_MODEL=claude-sonnet-4-6

1. 安装 Claude Code​

macOS / Linux / WSL​

打开 Terminal：

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

重启终端后验证：

claude --version

Windows PowerShell​

打开 PowerShell：

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

关闭并重新打开 PowerShell，然后验证：

claude --version

npm 安装方式​

如果你已经安装 Node.js 18+：

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

2. 创建 UniKey API Key​

  1. 打开 https://www.getunikey.ai/。
  2. 登录账号。
  3. 进入 API Key 或 Token 页面。
  4. 创建 API Key。
  5. 安全保存。

3. 使用 settings.json 配置​

这是最简单的方式，因为不会修改全局 Shell 配置。

系统文件路径
macOS/Users/<your-name>/.claude/settings.json
Linux / WSL/home/<your-name>/.claude/settings.json
WindowsC:\Users\<your-name>\.claude\settings.json

如果 .claude 文件夹不存在，请先创建。

macOS/Linux/WSL：

mkdir -p ~/.claude
nano ~/.claude/settings.json

Windows PowerShell：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

粘贴以下 JSON，并把 sk-... 替换成你的 UniKey API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_BASE_URL": "https://www.getunikey.ai",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "API_TIMEOUT_MS": "3000000"
  }
}

保存文件后重启终端。

4. 使用环境变量配置​

如果你更喜欢 Shell 级别配置，可以使用这种方式。

macOS zsh​

编辑：

nano ~/.zshrc

加入：

export ANTHROPIC_BASE_URL="https://www.getunikey.ai"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="claude-sonnet-4-6"

重新加载：

source ~/.zshrc

Linux bash​

编辑：

nano ~/.bashrc

加入：

export ANTHROPIC_BASE_URL="https://www.getunikey.ai"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="claude-sonnet-4-6"

重新加载：

source ~/.bashrc

Windows PowerShell​

编辑 PowerShell 配置文件：

notepad $PROFILE

加入：

$env:ANTHROPIC_BASE_URL = "https://www.getunikey.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-4-6"

重新加载：

. $PROFILE

5. 运行 Claude Code​

claude

发送：

Reply with one sentence saying Claude Code is connected through UniKey.

如果模型正常回复，说明配置成功。

6. 切换模型​

只对当前命令临时切换：

ANTHROPIC_MODEL=claude-opus-4-6 claude

Windows PowerShell：

$env:ANTHROPIC_MODEL = "claude-opus-4-6"; claude

永久切换：修改 settings.json、~/.zshrc、~/.bashrc 或 $PROFILE 中的 ANTHROPIC_MODEL，然后重启终端。

推荐模型 ID​

  • claude-sonnet-4-6
  • claude-sonnet-4-5
  • claude-opus-4-6
  • claude-opus-4-5
  • claude-haiku-4-5
  • gpt-5.2
  • gpt-5.4
  • gpt-5.4-mini
  • gpt-5.5
  • deepseek-v3.2
  • kimi-k2.5

Claude Code 对工具调用稳定性要求较高。如果某个模型在编码任务中失败，优先切换到 Claude 兼容模型。

常见问题​

现象处理方式
找不到 claude 命令重启终端。如果仍失败，重新安装 Claude Code。
401 unauthorized检查 ANTHROPIC_AUTH_TOKEN，确认没有多余空格或引号错误。
403 access denied确认账号有该模型权限，并且 Credits 余额充足。
请求超时保持较高 API_TIMEOUT_MS，并在稳定网络下重试。
模型不对在 Claude Code 内输入 /status，检查 ANTHROPIC_MODEL。
settings 未生效确认文件路径正是 ~/.claude/settings.json 或 %USERPROFILE%\.claude\settings.json，然后重启终端。