Codex 与 Claude Code
Codex 和 Claude Code 可以用 Yi Cloud 的模型。它们发出的每个请求都是一次普通的模型 API 调用,从你的余额里扣费。
准备
给 agent 单独建一个 key。「用途」只选「模型 API」,并设一个花费上限。见 API Key 与限额。
在启动 agent 的 shell 里,把 key 放进环境变量:
shexport YI_CLOUD_API_KEY="pwc_live_..."在价格页或
GET https://cloud.theyilabs.com/v1/catalog里挑模型。
Codex
Codex 用的是 Responses API,所以只能用目录里 responses_api: true 的模型。列出这些模型:
sh
curl -s https://cloud.theyilabs.com/v1/catalog | jq -r '.models[] | select(.responses_api) | .id'在 ~/.codex/config.toml 里把 Yi Cloud 加为一个 provider:
toml
model = "gpt-6.1-sol"
model_provider = "yicloud"
[model_providers.yicloud]
name = "Yi Cloud"
base_url = "https://cloud.theyilabs.com/v1"
env_key = "YI_CLOUD_API_KEY"
wire_api = "responses"然后照常在项目里启动 Codex:codex,或者用 codex exec "..." 跑单个任务。
base_url以/v1结尾。- Codex 从
env_key指定的环境变量读 key,不用登录 Codex。 - 不支持 Responses 的模型会返回
400 invalid_request,消息是 "This model does not support Responses"。
Claude Code
Claude Code 用的是 Anthropic Messages,目录里的对话模型都能回答它。在 shell 里设好下面这些变量,再在项目里启动 Claude Code:
sh
export ANTHROPIC_BASE_URL="https://cloud.theyilabs.com"
export ANTHROPIC_AUTH_TOKEN="$YI_CLOUD_API_KEY"
export ANTHROPIC_MODEL="gemini-3.1-pro"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gemini-3.1-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="gemini-3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gemini-3.5-flash"
claudeANTHROPIC_BASE_URL是控制台的地址,不带/v1,路径由 Claude Code 自己加。ANTHROPIC_AUTH_TOKEN会把 key 放在Authorization: Bearer里发出,不用登录 Claude Code。- Claude Code 会按 Opus、Sonnet、Haiku 这三个名字,为不同的活要不同的模型,后台的小活交给 Haiku 那个。四个模型变量都要设成目录里的 ID。目录里没有的 ID 会返回
404 not_found。 - Claude Code 的联网搜索要用服务端工具,Yi Cloud 不接受。搜索会失败,Claude Code 会跳过它继续干活。
- Claude Code 自己显示的费用用的是它自己的价格表,不是 Yi Cloud 的。实际扣了多少,以控制台为准。
怎么算钱
agent 每走一步就是一个请求,每个请求都会把到目前为止的整段对话再发一遍,所以输入 token 涨得很快。模型缓存了重复的部分时,这部分按缓存输入的价格算。
每个请求开始前,Yi Cloud 会预扣它最多可能花的钱,请求允许的输出 token 全部算在内,见一次调用怎么算钱。Codex 和 Claude Code 每个请求允许大约 32,000 个输出 token,所以预扣比一步实际花的钱多得多。请求结束后预扣就释放。
- key 的花费上限要在已花的钱之上,再留出一次完整预扣的空间。不然下一个请求会返回
402 key_limit_reached,即使这一步实际花不了那么多,agent 也会停下来。余额也一样,不够时返回402 insufficient_funds。 - 用 Claude Code 时,可以把
CLAUDE_CODE_MAX_OUTPUT_TOKENS设小一些,比如8000,每次预扣就会变小。需要更长回答的那一步会被截断。 - 控制台「模型 API」页的「最近请求」里能看到每个请求和它的费用。见计费与回执。
出错了
| 看到的 | 要查什么 |
|---|---|
401 invalid_key | 环境变量里的 key 写错了,或者已经吊销。 |
403 forbidden | key 的用途里没有「模型 API」,或者这个模型不在 key 允许的范围内。 |
404 not_found | 有模型 ID 不在目录里。用 Claude Code 时,四个模型变量都查一遍。 |
400 invalid_request,"This model does not support Responses" | Codex 要用 responses_api: true 的模型。 |
402 insufficient_funds | 余额不够下一个请求的预扣。见计费与回执。 |
402 key_limit_reached | key 的花费上限用完了,或者剩下的不够下一次预扣。见怎么算钱。 |
每个错误里都有 request_id,问我们某个请求时请带上它。