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"启动与验证
- 按 Codex CLI 官方文档完成安装。
- 在设置了
BAMBOO_API_KEY的同一终端进入项目目录。 - 运行
codex启动新会话。 - 先询问一个只读问题,确认模型、流式响应与工具描述可以正常传输。
常见问题
wire_api必须是responses,不能改成chat或chat_completions。- 返回
404:确认 Base URL 为https://api.bamboonode.cn/v1,没有重复/v1。 - 普通问答成功但工具调用失败:换用明确支持 Responses 与工具调用的模型。