本项目专为 Claude Code 设计，将 Codex Responses API 格式转换为 Anthropic Messages API 格式，使 Claude Code 能够使用 aicodemirror 的 Codex API。
✅ 完整功能支持
- 文本对话流式响应
- 工具调用（shell_command、apply_patch、view_image、MCP 等）
- 图片支持
- 推理强度配置（reasoning_effort）
- 工具结果反馈循环
- 桌面端安装包仅提供 macOS/Windows，Linux 请使用命令行启动
从 Releases 下载对应平台的安装包。
说明：Release 资产文件名可能不带版本号，请以 Release 标题/发布时间为准选择最新版本。
当前仅提供 macOS/Windows 安装包；Linux 暂无安装包，请使用命令行方式启动。
macOS 用户注意：如果打开应用时提示"已损坏"，请在终端执行：
xattr -cr /Applications/Codex\ Proxy.app
Claude Code 配置文件路径：~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "http://localhost:8889",
"ANTHROPIC_AUTH_TOKEN": "sk-ant-api03-你的API密钥"
},
"forceLoginMethod": "claudeai",
"permissions": {
"allow": [],
"deny": []
}
}代理服务器默认监听 http://localhost:8889
| Anthropic 参数 | Codex 参数 | 说明 |
|---|---|---|
messages |
input |
消息内容 |
system |
instructions |
系统提示 |
tools |
tools |
工具定义 |
{
"type": "content_block_delta",
"delta": { "type": "text_delta", "text": "Hello!" },
"index": 0
}工具调用：
{
"type": "content_block_start",
"content_block": {
"type": "tool_use",
"id": "tool_123",
"name": "shell_command",
"input": {}
}
}| 工具名称 | 类型 | 说明 |
|---|---|---|
shell_command |
function | 执行 Shell 命令 |
apply_patch |
custom | 文件编辑（FREEFORM） |
view_image |
function | 查看本地图片 |
list_mcp_resources |
function | 列出 MCP 资源 |
list_mcp_resource_templates |
function | 列出 MCP 资源模板 |
read_mcp_resource |
function | 读取 MCP 资源 |
update_plan |
function | 更新任务计划 |
原因：工具定义格式不完整
解决：确保使用 Codex 模板中的完整工具定义，或让代理自动使用模板工具
原因：图片 URL 格式不支持
解决：Claude Code 使用 file:// 协议时，需要确保代理正确转换
原因：instructions 格式不正确
解决：代理会自动使用 Codex CLI 的完整 instructions 模板
- 代理服务器:
http://localhost:8889/v1/messages - Codex API:
https://api.aicodemirror.com/api/codex/backend-api/codex/responses
本项目仅供学习和研究使用。