接入教程:把 Codex CLI 和 Claude Code 连到你的工作区
工作区对外提供 OpenAI Responses、Chat Completions 和 Anthropic Messages 三种协议。下面的域名是示例,请换成工作区页面上实际提供的地址。
第一步:创建成员 Key
登录后进入工作区,在成员 API 页面创建一个成员 Key,并记下工作区已启用模型卡片上的模型名称。Key 只显示一次,请妥善保存。
第二步:配置 Codex CLI
Codex CLI 使用 Responses 协议。在 ~/.codex/config.toml 里添加一个模型提供方,并把成员 Key 放进环境变量:
model_provider = "workspace"
model = "<模型卡片上的模型名>"
[model_providers.workspace]
name = "My Workspace"
base_url = "https://your-workspace.example/v1"
env_key = "WORKSPACE_API_KEY"
wire_api = "responses"export WORKSPACE_API_KEY="<你的成员 Key>"第三步:配置 Claude Code
Claude Code 使用 Anthropic Messages 协议。设置下面两个环境变量后启动 claude 即可;地址不要带 /v1:
export ANTHROPIC_BASE_URL=https://your-workspace.example
export ANTHROPIC_AUTH_TOKEN="<你的成员 Key>"其他 OpenAI 兼容工具
大多数 Agent 工具和 SDK 支持 Chat Completions 协议,填写 base_url 为工作区地址加 /v1、API Key 为成员 Key 即可。上游只有 Chat 接口时,Responses 请求会自动转换。
base_url = "https://your-workspace.example/v1"第四步:核对结果
发送一条简短请求,再到「用量与账单」核对记录。鉴权失败先检查 Key 和成员状态;提示模型不可用时检查模型名、卡片和来源状态。不同协议路径不同,请按页面提供的地址填写,不要重复拼接 /v1。