激活额度
登录控制台，在钱包管理或额度充值相关入口完成兑换码激活或充值。
Access Overview
CodeAPI 接入总览
先按顺序完成激活额度、创建 API Key 和客户端配置，通常就能顺利接入。
兑换码在控制台的钱包或额度充值相关入口使用。创建好 API Key 后，再去对应客户端完成配置。
Steps
完成接入通常只需要这三步
按这个顺序操作，通常更容易完成接入并减少反复排查。
创建 API Key
进入令牌管理创建并保存 sk- 开头的密钥，后续所有客户端都用这一凭证完成认证。
进入专题页配置客户端
根据你实际使用的工具进入 Claude Code、Codex 或 OpenCode 专题页，按对应配置片段完成接入。
Matrix
按工具进入，快速查看对应说明
按你正在使用的工具，直接选对应配置方式。
Claude Code 专题页
包含 settings.json 路径、配置片段、环境变量方式与常见报错排查。
进入 Claude Code 页Codex 专题页
覆盖 config.toml、auth.json、环境变量、模型名与常见连接问题。
进入 Codex 页OpenCode 专题页
覆盖 opencode.json、provider 配置、auth login、/models 验证与常见问题排查。
进入 OpenCode 页CC-Switch
适合通过图形界面管理多种提供方，降低重复手动配置成本。
查看 CC-Switch 教程OpenClaw
适合机器人和兼容客户端场景，可按版本使用 Anthropic 或 OpenAI 兼容环境变量。
查看 OpenClaw 教程
CC-Switch
CC-Switch 详细接入步骤
适合希望通过图形界面统一管理 Claude Code 和 Codex 配置的用户。按下面顺序填写，通常不需要再手动改本地文件。
开始前准备
- 已创建 CodeAPI API Key
- 本地已安装 CC-Switch
- 明确当前要接入 Claude Code 还是 Codex
支持平台
- Windows：下载 Release 安装包后直接打开
- macOS：可用安装包或包管理器方式安装
- Linux：使用 Release 包或兼容发行版安装方式
步骤 1：打开并选择目标工具
启动 CC-Switch 后，先在左侧切换到你要配置的工作流，例如 Claude Code 或 Codex CLI。
步骤 2：新增自定义 Provider
点击 Add Custom Provider，名称可以自定义为 CodeAPI，关键是把 Base URL 和 API Key 填对。
步骤 3：Claude Code 模式填写
如果你配置的是 Claude Code，Base URL 填 https://api.codeapi.work/，认证密钥填已创建的 sk- 开头 API Key。
步骤 4：Codex 模式填写
如果你配置的是 Codex，Base URL 使用 https://api.codeapi.work/v1，并把模型名设置为 gpt-5-codex 或当前可用的 Codex 模型。
推荐填写值
Claude Code
Base URL: https://api.codeapi.work/
API Key: sk-your-token
Codex
Base URL: https://api.codeapi.work/v1
Model: gpt-5-codex
API Key: sk-your-token保存后如何验证
点击 Save 或 Apply 后，重新打开对应客户端并发起一次简单请求。如果能正常返回结果，通常说明 CC-Switch 已把配置写入成功。
补充说明
如果切换后没有生效，优先检查旧环境变量是否仍在覆盖，或当前工作流是否选错成了 Claude / Codex 的另一套配置。
Snippets
兼容客户端最短配置示例
这些示例用于帮助你确认所需的兼容模式，详细说明可结合专题页查看。
OpenClaw: Anthropic 兼容
ANTHROPIC_BASE_URL=https://api.codeapi.work/
ANTHROPIC_API_KEY=sk-your-tokenOpenClaw: OpenAI 兼容
OPENAI_BASE_URL=https://api.codeapi.work/v1
OPENAI_API_KEY=sk-your-token
OpenClaw
OpenClaw 详细接入步骤
适合机器人、网关或第三方兼容客户端场景。关键是先确认你当前使用的是 Anthropic 兼容模式，还是 OpenAI 兼容模式。
开始前准备
- 本地已安装 OpenClaw
- 已准备好 CodeAPI 的 API Key
- Windows 环境建议提前准备 Git 与 Node.js
平台建议
- Linux：通常可以直接用安装脚本
- macOS：优先使用官网安装包
- Windows：先补齐依赖，再走 npm 或官方安装流程
Anthropic 兼容模式
ANTHROPIC_BASE_URL=https://api.codeapi.work/
ANTHROPIC_API_KEY=sk-your-tokenOpenAI 兼容模式
OPENAI_BASE_URL=https://api.codeapi.work/v1
OPENAI_API_KEY=sk-your-token修改后重启 gateway
openclaw gateway restart如何验证已经生效
重启 gateway 后，到 OpenClaw 的聊天页或你的目标机器人里发起一次消息。如果能正常返回结果，通常说明配置已经生效。
选择模式时注意
如果你看到 404 或请求格式错误，优先检查是不是兼容模式选错了。Anthropic 模式走根路径，OpenAI 模式通常需要 /v1。
Checklist
配置失败时，先按这个顺序自检
如果配置未生效，建议先按这个顺序检查常见项。
通用检查项
- API Key 是否有效
- Base URL 是否填写正确
- 模型名是否和当前配置一致
- 客户端是否已经完全重启
出现 401 / 403 / 404 时
- 401 / 403 通常优先检查 API Key 状态
- 404 通常优先检查 Base URL，尤其是是否遗漏 /v1
- 模型不可用时，先确认模型名和调用方式
Next
已确定客户端后，继续查看对应专题页
直接进入 Claude Code、Codex 或 OpenCode 专题页查看完整配置；如果还在评估，可先看价格页与 FAQ。