Bamboo Relay

Codex CLI

通过 OpenAI Responses 兼容接口将 Codex CLI 连接到 Bamboo Relay。

协议要求

Codex 自定义模型提供商当前使用 Responses 协议。请选择 Bamboo 中支持 /v1/responses、流式输出和工具调用的模型。

Codex CLI 是 OpenAI 提供的本地 Coding Agent。下面创建独立的 bamboo 提供商,不覆盖 Codex 内置的 openai 配置。

配置 API Key

先在令牌管理创建 Bamboo API Key:

export BAMBOO_API_KEY="sk-your-api-key"

建议把变量交给系统密钥管理工具或 Shell 配置管理;不要将真实密钥写入仓库。

配置 Codex

编辑用户级配置文件 ~/.codex/config.toml,把 your-model-id 替换为模型广场中的模型 ID:

model = "your-model-id"
model_provider = "bamboo"

[model_providers.bamboo]
name = "Bamboo Relay"
base_url = "https://api.bamboonode.cn/v1"
env_key = "BAMBOO_API_KEY"
wire_api = "responses"

启动与验证

  1. Codex CLI 官方文档完成安装。
  2. 在设置了 BAMBOO_API_KEY 的同一终端进入项目目录。
  3. 运行 codex 启动新会话。
  4. 先询问一个只读问题,确认模型、流式响应与工具描述可以正常传输。

常见问题

  • wire_api 必须是 responses,不能改成 chatchat_completions
  • 返回 404:确认 Base URL 为 https://api.bamboonode.cn/v1,没有重复 /v1
  • 普通问答成功但工具调用失败:换用明确支持 Responses 与工具调用的模型。

相关文档

本页目录