Codex 接入教程

开发者工具命令行工具更新时间：2026-06-29

产品简介

Codex 是 OpenAI 推出的终端 AI 编程助手，通过命令行界面为开发者提供智能代码辅助。通过海鲸AI的 OpenAI 兼容接口，您可以在 Codex 中接入 GPT 系列模型，享受高质量的编程体验。

核心功能

💻 智能代码生成 - 根据需求自动编写代码
🐛 代码调试分析 - 快速定位和修复 Bug
♻️ 代码重构优化 - 改进代码结构和性能
📝 文档自动生成 - 为代码添加注释和文档
🔍 代码理解解释 - 解释复杂代码逻辑
🚀 多语言支持 - 支持 Python、JavaScript、Java、Go 等主流语言

为什么选择海鲸AI？

优势	说明
💰 灵活计费	按需付费，无需订阅
🌐 国内直连	无需科学上网，国内网络直接访问
⚡ 高性能	低延迟，响应迅速
🔒 数据安全	代码数据不存储，保护隐私
🆓 新人福利	新用户可获得免费额度
🔄 多模型	一套配置，自由切换 GPT 各版本

支持的模型

海鲸AI 通过 OpenAI 兼容接口接入 Codex，支持以下常用模型：

模型列表

模型系列	模型名称	特点	适用场景
GPT	`gpt-5.5`、`gpt-4.1`	• 综合能力强 • 推理准确	复杂任务、架构设计

协议兼容性

Codex 当前版本仅支持 Responses API，海鲸AI 中目前仅 GPT 系列模型已适配该协议。其他模型（如 Claude、DeepSeek、通义千问）请使用 Claude Code 等其它客户端接入。

模型选择建议

主模型推荐：gpt-5.5（综合能力强、代码质量高）
快速模型推荐：gpt-4.1（性价比更高、响应更快）
完整模型列表：参见模型列表

前置准备

1. 获取海鲸AI API Key

访问海鲸AI控制台
注册并登录账户
在 API 管理页面生成 API Key
确保账户有足够余额或免费额度

新用户福利

首次注册海鲸AI，可获得新人免费额度：

✅ 可用于所有模型推理服务

2. 系统要求

项目	要求
操作系统	macOS 10.15+、Windows 10+、Linux
Node.js	v18.0+
npm	v9.0+
终端	支持彩色输出的现代终端

安装步骤

1. 安装 Codex CLI

macOS/LinuxWindows

bash

# 使用 npm 全局安装最新版
npm install -g @openai/codex

# 验证安装
codex --version

powershell

# 使用 npm 全局安装最新版
npm install -g @openai/codex

# 验证安装
codex --version

安装提示

如果遇到权限问题，可能需要使用 sudo（macOS/Linux）
Windows 用户建议以管理员身份运行 PowerShell
国内用户可使用 npm 镜像加速：npm config set registry https://registry.npmmirror.com

版本说明

请安装 Codex 最新版（默认使用 Responses API）。海鲸AI 接入需要 Responses 协议，旧版本（如 0.80.0）的 wire_api = "chat" 模式已不再支持。

2. 配置 Codex 接入海鲸AI

Codex 通过 ~/.codex/config.toml 配置接入端点，通过环境变量 OPENAI_API_KEY 传入鉴权信息。

编辑配置文件

打开（或新建）~/.codex/config.toml，写入以下内容：

toml

model_provider = "HaiJingAI"
model = "gpt-5.5"

[model_providers.HaiJingAI]
name = "HaiJingAI"
base_url = "https://api.atalk-ai.com/v2"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

配置说明

model_provider：自定义的服务商标识，与下方 [model_providers.xxx] 对应
model：默认使用的模型，可改为 GPT 系列任意支持 Responses 协议的模型 ID
base_url：海鲸AI 的 OpenAI 兼容端点
wire_api：必须为 responses，Codex 新版本已不再支持 chat

配置环境变量

将 OPENAI_API_KEY 设置为您的海鲸AI API Key（不是 OpenAI 官方 Key）。

Zsh (macOS 默认)BashWindows PowerShell

bash

# 将 sk-xxx 替换为您的海鲸AI API Key
echo 'export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

bash

echo 'export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

powershell

# 临时生效（当前会话）
$env:OPENAI_API_KEY = "sk-xxxxxxxxxxxxxxxx"

# 永久生效（用户级）
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-xxxxxxxxxxxxxxxx", "User")

执行以下命令查看当前 Shell 类型：

bash

echo $SHELL

3. 验证配置

新建终端窗口后，执行以下命令启动 Codex：

bash

codex

如果正常进入对话界面，并能通过简单提问获得响应，说明配置成功。

bash

> 写一个 Python 函数，判断字符串是否是回文

使用指南

基础使用

1. 启动 Codex

bash

# 进入项目目录
cd my-project

# 启动 Codex
codex

2. 切换模型

修改 ~/.codex/config.toml 中的 model 字段即可切换默认模型，例如：

toml

model = "gpt-5.5"       # 默认推荐，综合能力最强
# model = "gpt-4.1"     # 性价比更高、响应更快

修改保存后重新启动 codex 即可生效。

3. 常用命令

命令	功能
`/help`	查看帮助
`/clear`	清空对话历史
`/exit`	退出程序

节省 Token 技巧

合理使用 Codex 可以显著减少 Token 消耗，降低成本。

1. 减少无关文件扫描

最佳实践

✅ 在具体项目目录中启动 Codex
✅ 使用 .gitignore 排除不必要的文件
✅ 删除或移动大型二进制文件
✅ 避免在根目录或包含多个项目的目录启动

2. 选择合适的模型

任务类型	推荐模型	原因
简单代码生成	`gpt-4.1`	速度快、成本低
复杂算法实现	`gpt-5.5`	推理准确、稳定
架构设计	`gpt-5.5`	综合能力最强

3. 提出精确的指令

❌ 模糊指令	✅ 精确指令
"优化这个代码"	"重构 user.py 中的 `get_user_list` 函数，使用列表推导式"
"帮我改一下"	"在 index.js 第 45 行添加错误处理，捕获 API 调用失败"
"这里有问题"	"修复 calculate.py 中的除零错误，添加输入验证"

常见问题

Q1：报错 `wire_api = chat is no longer supported` 怎么办？

原因： Codex 新版本已不再支持 wire_api = "chat"。

解决方案： 将 ~/.codex/config.toml 中的配置改为 wire_api = "responses"，并将 model 切换为海鲸AI 已支持 Responses 协议的 GPT 系列模型。

Q2：报错 `401 Unauthorized` 怎么办？

可能原因：

API Key 拼写错误、含有空格或多余字符
使用了 OpenAI 官方 Key 而非海鲸AI Key
账户余额不足或 Key 已被禁用

解决方案：

重新复制完整的海鲸AI API Key
确认环境变量已生效：echo $OPENAI_API_KEY
登录海鲸AI控制台检查 Key 状态
如有需要，重置 API Key 后重新配置

Q3：报错 `404 Not Found` 怎么办？

原因： base_url 或 wire_api 填写错误。

解决方案：

确认 base_url = "https://api.atalk-ai.com/v2"（注意 /v2 结尾）
确认 model 名称在模型列表中存在
确认 model 为 GPT 系列（其它模型暂未支持 Responses 协议）

Q4：环境变量配置后仍然不生效？

解决方案：

确认编辑的是当前 Shell 对应的配置文件（Zsh 用 ~/.zshrc，Bash 用 ~/.bashrc）
执行 source ~/.zshrc（或 ~/.bashrc）使其生效
新开一个终端窗口再次尝试
通过 echo $OPENAI_API_KEY 验证

Q5：可以同时配置多个模型服务商吗？

可以。在 ~/.codex/config.toml 中定义多个 [model_providers.xxx] 段，并通过 model_provider 切换即可：

toml

model_provider = "HaiJingAI"
model = "gpt-5.5"

[model_providers.HaiJingAI]
name = "HaiJingAI"
base_url = "https://api.atalk-ai.com/v2"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

[model_providers.OpenAI_Official]
name = "OpenAI_Official"
base_url = "https://api.openai.com/v2"
env_key = "OPENAI_OFFICIAL_KEY"
wire_api = "responses"

Q6：如何保护代码隐私？

海鲸AI承诺：

🔒 不存储代码内容 - 请求处理后立即删除
🔒 端到端加密 - 传输过程全程加密
🔒 不用于训练 - 您的代码不会用于模型训练

安全建议

不要在代码中包含敏感信息（密码、密钥等）
对于极度敏感的项目，建议使用本地模型
定期检查 API Key 使用情况

📚 快速开始指南 - 了解海鲸AI API 基础
🔧 API 参考文档 - 查看完整 API 接口
💰 价格说明 - 了解计费详情
🎯 模型列表 - 查看所有可用模型
🛠️ Claude Code 接入教程 - Claude 官方 CLI 接入
🛠️ 通义灵码接入教程 - 通义灵码接入

Codex 接入教程 ​

产品简介 ​

核心功能 ​

为什么选择海鲸AI？ ​

支持的模型 ​

模型列表 ​

前置准备 ​

1. 获取海鲸AI API Key ​

2. 系统要求 ​

安装步骤 ​

1. 安装 Codex CLI ​

2. 配置 Codex 接入海鲸AI ​

编辑配置文件 ​

配置环境变量 ​

3. 验证配置 ​

使用指南 ​

基础使用 ​

1. 启动 Codex ​

2. 切换模型 ​

3. 常用命令 ​

节省 Token 技巧 ​

1. 减少无关文件扫描 ​

2. 选择合适的模型 ​

3. 提出精确的指令 ​

常见问题 ​

Q1：报错 wire_api = chat is no longer supported 怎么办？ ​

Q2：报错 401 Unauthorized 怎么办？ ​

Q3：报错 404 Not Found 怎么办？ ​

Q4：环境变量配置后仍然不生效？ ​

Q5：可以同时配置多个模型服务商吗？ ​

Q6：如何保护代码隐私？ ​

相关资源 ​

Codex 接入教程

产品简介

核心功能

为什么选择海鲸AI？

支持的模型

模型列表

前置准备

1. 获取海鲸AI API Key

2. 系统要求

安装步骤

1. 安装 Codex CLI

2. 配置 Codex 接入海鲸AI

编辑配置文件

配置环境变量

3. 验证配置

使用指南

基础使用

1. 启动 Codex

2. 切换模型

3. 常用命令

节省 Token 技巧

1. 减少无关文件扫描

2. 选择合适的模型

3. 提出精确的指令

常见问题

Q1：报错 `wire_api = chat is no longer supported` 怎么办？

Q2：报错 `401 Unauthorized` 怎么办？

Q3：报错 `404 Not Found` 怎么办？

Q4：环境变量配置后仍然不生效？

Q5：可以同时配置多个模型服务商吗？

Q6：如何保护代码隐私？

相关资源