01tree Codex 接入指南

本文说明如何把 OpenAI Codex CLI / Codex App 接入 01tree。完成后，Codex 会通过 01tree 的 OpenAI Responses 兼容接口工作。

接入信息

快速接入

1. 准备 API Key

打开 01tree API Keys，创建或复制自己的 01tree API Key（sk-ant-oat01- 开头）。

打开 01tree USD 余额，确认余额可用。

2. 永久保存 API Key

将 YOUR_01TREE_API_KEY 替换为你的真实 API Key 后执行：

macOS / Linux：

echo '' >> ~/.zshrc
echo '# 01tree Codex CLI' >> ~/.zshrc
echo 'export TREE01_API_KEY="YOUR_01TREE_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell：

[System.Environment]::SetEnvironmentVariable(
  "TREE01_API_KEY", "YOUR_01TREE_API_KEY",
  [System.EnvironmentVariableTarget]::User
)

3. 写入 Codex 配置

编辑或创建 ~/.codex/config.toml：

model = "gpt-5.5"
model_provider = "01tree"

[model_providers."01tree"]
name = "01tree"
base_url = "https://01tree.ai/codex/v1"
env_key = "TREE01_API_KEY"
wire_api = "responses"

env_key 写的是变量名，不是真实 API Key。Codex 会读取 TREE01_API_KEY 环境变量的值作为真实 Key。

4. 验证

cd /path/to/your/project
codex exec "请只回复：01tree Codex 已连接。"

成功时应该看到「01tree Codex 已连接。」，同时 USD 余额页 有请求记录。

Codex App / Desktop

从终端启动可继承环境变量：

codex app /path/to/your/project

从桌面图标启动时可能读不到 shell 环境变量。如果 CLI 能用但 App 不能，优先从终端 codex app 启动。

常见问题

• 404 错误：确认 base_url 是 https://01tree.ai/codex/v1，不要加 /responses。
• 找不到 API Key：运行 test -n "$TREE01_API_KEY" && echo set || echo missing 检查。
• 有回复但无账单记录：检查 model_provider 是否已切到 01tree。
• 模型列表为空：手动填写模型 ID，例如 gpt-5.5。

安装 Codex CLI

# npm
npm install -g @openai/codex

# 或 Homebrew (macOS)
brew install --cask codex

# 验证
codex --version

参考链接

• OpenAI Codex CLI 文档
• Codex GitHub
• 01tree API Keys
• 01tree USD 余额
• 01tree 工单系统