Skip to content

Codex 与 Claude Code ​

Codex 和 Claude Code 可以用 Yi Cloud 的模型。它们发出的每个请求都是一次普通的模型 API 调用,从你的余额里扣费。

准备 ​

  1. 给 agent 单独建一个 key。「用途」只选「模型 API」,并设一个花费上限。见 API Key 与限额。

  2. 在启动 agent 的 shell 里,把 key 放进环境变量:

    sh
    export YI_CLOUD_API_KEY="pwc_live_..."
  3. 在价格页或 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"
claude
  • ANTHROPIC_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 forbiddenkey 的用途里没有「模型 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_reachedkey 的花费上限用完了,或者剩下的不够下一次预扣。见怎么算钱。

每个错误里都有 request_id,问我们某个请求时请带上它。