Codex 安装与配置进阶

node --version   # 应输出 v22.x.x

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

curl -I https://tokenflash.cn/v1/models \
  -H "Authorization: Bearer sk-your-key"

npm install -g @openai/codex

brew -v
brew install --cask codex

wsl --install -d Ubuntu-24.04

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
npm install -g @openai/codex

npm install -g @openai/codex

# x86_64
curl -L https://github.com/openai/codex/releases/download/rust-v0.131.0/codex-x86_64-unknown-linux-musl.tar.gz | tar -xz
sudo mv codex /usr/local/bin/

# ARM64（将文件名中的 x86_64 替换为 aarch64 即可）

codex --version

# 一行命令快速验证配置
OPENAI_BASE_URL="https://tokenflash.cn/v1" \
  OPENAI_API_KEY="sk-xxx" \
  codex "输出 hello world"

export OPENAI_BASE_URL="https://tokenflash.cn/v1"
export OPENAI_API_KEY="sk-你的API密钥"

echo 'export OPENAI_BASE_URL="https://tokenflash.cn/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc

OPENAI_BASE_URL="https://tokenflash.cn/v1" OPENAI_API_KEY="sk-xxx" codex "输出 hello world"

model = "gpt-5.6-sol"

[model_providers.tokenflash]
name = "TokenFlash"
base_url = "https://tokenflash.cn/v1"
env_key = "OPENAI_API_KEY"

provider = "tokenflash"

model = "gpt-5.6-sol"

[model_providers.tokenflash]
name = "TokenFlash"
base_url = "https://tokenflash.cn/v1"
env_key = "OPENAI_API_KEY"

provider = "tokenflash"

# 通过 --model 指定模型
codex --model gpt-5.6-sol "复杂架构设计任务"
codex --model gpt-5.6-terra "日常编码任务"
codex --model gpt-5.6-luna "简单快速任务"

export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"

[proxy]
url = "http://127.0.0.1:7890"

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_TOKEN = "ghp_xxx" }

# 默认模型
model = "gpt-5.6-sol"

# 默认沙箱模式
approval_mode = "auto-edit"

# TokenFlash
[model_providers.tokenflash]
name = "TokenFlash"
base_url = "https://tokenflash.cn/v1"
env_key = "OPENAI_API_KEY"

# 默认提供者
provider = "tokenflash"

# 全局指令
echo "始终使用 TypeScript，遵循 ESLint 推荐的代码风格。" > ~/.codex/instructions.md

# 项目级指令（优先级更高）
echo "本项目使用 Python 3.12 + FastAPI。" > .codex/instructions.md

codex --model gpt-5.6-sol "在当前目录创建一个 Express.js REST API 项目，包含用户 CRUD，使用 SQLite，包含错误处理和输入验证"

codex --model gpt-5.6-sol "审查 src/ 目录下的所有代码，找出潜在的性能问题和安全漏洞"

codex --model gpt-5.6-terra "为 src/utils/ 下的工具函数编写完整的单元测试，使用 Jest 框架"

✅ Task completed
─────────────────────────────
  Tokens used:
    Prompt:     3,245 tokens
    Completion: 1,892 tokens
    Total:      5,137 tokens
─────────────────────────────
  Cost estimate: $0.0182 (gpt-5.6-terra)

# 用 gpt-5.6-luna 完成简单任务（速度最快）
time codex --model gpt-5.6-luna "写一个冒泡排序算法"
# 响应快，成本低

# 用 gpt-5.6-terra 完成同样任务（日常推荐）
time codex --model gpt-5.6-terra "写一个冒泡排序算法"

# 用 gpt-5.6-sol 完成同样任务（最详细）
time codex --model gpt-5.6-sol "写一个冒泡排序算法"
# 可能更详细，但成本更高

你好，请用一句话介绍你自己

curl https://tokenflash.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Error: 401 Unauthorized / Invalid API key provided

# 1. 确认 API Key 已设置
echo $OPENAI_API_KEY

# 2. 确认 Base URL 包含 /v1
echo $OPENAI_BASE_URL   # 正确：https://tokenflash.cn/v1  错误：https://tokenflash.cn

# 3. 直接测试连通性
curl -s https://tokenflash.cn/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200

Error: 404 The model 'xxx' does not exist

# 查看可用模型列表
curl -s https://tokenflash.cn/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | python3 -m json.tool

# 确认拼写：gpt-5.6-sol（正确）、GPT-5.6-Sol（大小写错误）、gpt5.6sol（缺少短横线）

Error: ETIMEDOUT - Connection timed out

# 检查代理设置，按需配置
export HTTPS_PROXY="http://127.0.0.1:7890"

# 测试网络
curl -v --connect-timeout 5 https://tokenflash.cn/v1/models

Error: Sandbox initialization failed / Docker is not running

# 1. 确认 Docker 在运行
docker info

# 2. 确认当前用户在 docker 组中
groups | grep docker

# 3. WSL2 用户：确保 Docker Desktop 的 WSL2 集成已启用
# Docker Desktop → Settings → Resources → WSL Integration

# 4. 临时跳过沙箱测试
codex --sandbox none "你的任务"

# 检查网络设置和代理配置
env | grep -i proxy

# 等待一段时间后重试，或降低请求频率
# TokenFlash 不同渠道有不同的速率限制

Error: insufficient balance

# 登录 TokenFlash 平台查看余额并充值
# 建议选择 GPT分组以降低成本

# 环境变量
export OPENAI_BASE_URL="https://tokenflash.cn/v1"
export OPENAI_API_KEY="sk-xxx"

# 基本使用
codex "你的任务描述"
codex --model gpt-5.6-sol "复杂架构设计"
codex --model gpt-5.6-terra "日常编码任务"
codex --model gpt-5.6-luna "简单快速任务"

# 沙箱模式
codex --sandbox suggest "任务"     # 最安全 - AI 仅建议
codex --sandbox auto-edit "任务"   # 平衡 - 文件自动编辑，命令需确认
codex --sandbox full-auto "任务"   # 最高效 - 全部自动执行

# 验证 API 连通性
curl -s $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200

~/.codex/config.toml               # 全局配置文件
~/.codex/instructions.md           # 全局自定义指令
<project>/.codex/instructions.md   # 项目级自定义指令

profile = "gpt5-tokenflash"

[profiles.gpt5-tokenflash]
model = "gpt-5.6-sol"
model_provider = "tokenflash"
model_reasoning_effort = "high"

[profiles.deepseek]
model = "deepseek-v4-flash"
model_provider = "tokenflash-cn"
model_reasoning_effort = "medium"

[model_providers.tokenflash]
name = "TokenFlash API"
base_url = "https://tokenflash.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

# 项目规范
- 使用 TypeScript + React 开发
- 所有输出使用中文
- 测试框架使用 Jest