Integrations/Claude Code

接入 Claude Code

Claude Code 是 Anthropic 官方的命令行编程助手。Sozdai 提供 Anthropic 兼容的 Messages API,把 Claude Code 指向 Sozdai 即可用真实 Claude 模型、成本更低 —— 无需改任何代码。

#工作原理

Claude Code 走 Anthropic 的 Messages API。设置三个环境变量(base URL、令牌、以及一个空的 API key)后,每个请求都由 Sozdai API 处理,并从你的 Sozdai 余额扣费。

为什么 ANTHROPIC_API_KEY 要留空

如果设置了 ANTHROPIC_API_KEY,Claude Code 会直接把请求发给 Anthropic 而忽略你的 base URL。务必把它设为空字符串。

#前置准备

安装 Node.js 18+

Claude Code 需要 Node.js 18 或更高版本。

安装 Claude Code

bash

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

获取 Sozdai API key

在控制台的 API Keys 页创建一个密钥。它以 sk-corr- 开头,下面用作 ANTHROPIC_AUTH_TOKEN。

#按操作系统配置

选择你的系统按步骤操作。把 sk-corr-... 替换成你真实的 API key。

打开 shell 配置文件

macOS 默认使用 zsh。用编辑器打开 ~/.zshrc:

bash

nano ~/.zshrc

粘贴配置

bash

# ~/.zshrc
export ANTHROPIC_BASE_URL="https://api.sozdai.ai"
export ANTHROPIC_AUTH_TOKEN="sk-corr-..."
export ANTHROPIC_API_KEY=""
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

重新加载

无需重开终端即可生效:

bash

source ~/.zshrc

#模型映射

Claude Code 有三种模型角色。用下面这些变量把每个角色映射到 Sozdai 的模型名(上面的配置里已包含):

角色	环境变量	Sozdai 模型
主力 (Opus)	`ANTHROPIC_DEFAULT_OPUS_MODEL`	`claude-opus-4-8`
默认 (Sonnet)	`ANTHROPIC_DEFAULT_SONNET_MODEL`	`claude-sonnet-4-6`
后台 (Haiku)	`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`claude-haiku-4-5`

这些是必填的

Claude Code 内置的模型 ID 在 Sozdai 上可能不存在。不设这些覆盖,请求会报 model_not_found。可用模型名的完整列表见模型页。

#更省钱的模型(DeepSeek / Kimi)

不一定非用 Claude。DeepSeek 和 Kimi 价格只有 Claude 的零头,而且在 Claude Code 里完全可用 —— 包括工具调用(改文件、跑命令)和思考模式。把模型覆盖指向它们即可:

改 ~/.zshrc 或 ~/.bashrc 里这三行,然后重新加载:

bash

export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"

可自由搭配

三个角色可以分别设 —— 比如主力用 DeepSeek、后台快速角色用 Kimi;或者主力仍用真 Claude,只把 Sonnet/Haiku 换成便宜的。价格见模型页。

哪些模型支持 Claude Code

Claude、DeepSeek、Kimi 完全支持。Gemini 暂不兼容 Claude Code —— 请改用标准的 /v1/chat/completions 端点。

#验证

启动 Claude Code 并运行 /status。确认 API Base URL 指向 Sozdai、令牌已设置,然后正常使用即可。

bash

claude
# 然后在 Claude Code 里输入:
/status

#常见问题

现象	解决
请求还是发到 Anthropic	ANTHROPIC_API_KEY 不是空的 —— 设为 "" 并重开终端。
`model_not_found`	把 ANTHROPIC_DEFAULT_*_MODEL 设成 Sozdai 的模型名。
401 密钥无效	ANTHROPIC_AUTH_TOKEN 有误,或不是 sk-corr- 开头的密钥。
402 余额不足	在充值页给 Sozdai 余额充值。