Skip to content

Claude Code 调用 Codex 模型

Claude Code 不能直接把 Responses 模型当作 Anthropic 模型使用。本教程通过本地协议转换工具 ccNexus 接入;只使用 Claude 模型时,请直接看Claude Code 接入

1. 下载 ccNexus

ccNexus Releases下载适合当前系统的版本。模型兼容范围以当前 ccNexus Release 为准,不要照搬旧教程固定的模型名。

2. 添加 Lunora 端点

在 ccNexus 中添加端点:

  • 名称:Lunora Codex
  • API 地址:https://api.uselunora.com
  • API Key:Lunora 完整 Key
  • 转换器:OpenAI2 (Responses API)
  • 模型:ccNexus 当前支持且控制台可用的 Responses 模型

先执行检测,再保存端点。不要使用截图中的第三方域名。

3. 配置启动器和项目目录

选择 Claude Code,再选择希望使用的终端。

ccNexus:选择 Claude Code 终端
ccNexus 第三方界面示例;可用终端以本机安装情况为准。

添加专门的测试项目目录。

ccNexus:添加项目目录
不要一开始授权整个用户目录或磁盘。

4. 让 Claude Code 使用本地转换端口

ccNexus 默认示例使用:

  • API Base URL:http://localhost:3000
  • API Key:任意非空占位值,由本地代理替换
Claude Code:填写本地 ccNexus 地址
settings.json 只指向本机代理,不填写第三方公网地址。

不要把该本地端口暴露到公网,也不要关闭操作系统防火墙来解决本机连接问题。

5. 启动并信任测试目录

在 ccNexus 启动器中启动项目。Claude Code 第一次打开目录时,只对自己创建或确认安全的项目选择信任。

Claude Code:确认测试目录
不可信仓库应先检查内容,不要直接授权执行。

6. 完成第一次验证

发送一句简短问题,确认收到回复,并在 Lunora 用量记录中核对模型和时间。

Claude Code:通过 ccNexus 收到回复
界面显示名称可能仍是 Claude Code;实际模型以 ccNexus 配置和 Lunora 请求记录为准。

常见问题

localhost:3000 无法连接

确认 ccNexus 已启动对应端点和项目,检查当前端口是否被其他程序占用。

文本能回复,工具调用失败

该模型或当前 ccNexus 版本可能尚未兼容 Claude Code 的工具协议。更新 ccNexus,或换用当前明确支持的模型。

关闭 ccNexus 后无法使用

localhost 是本地转换服务,ccNexus 关闭后 Claude Code 无法继续通过该路径请求。

教程内容会随控制台功能持续更新