登录
SudoCode 配置文档

Claude Code 与 Codex 配置指南

使用同一个 SudoCode API Key 和统一 API Base，把 Claude Code、Codex 与 OpenAI 兼容客户端连接到 SudoCode。Claude Code 使用 https://api.sudocode.cyou，Codex 使用 https://api.sudocode.cyou/v1；按系统复制命令后替换 API Key 即可使用。

进入控制台创建 API Key

基础信息

Base API URL（Claude Code）
https://api.sudocode.cyou
OpenAI 兼容 URL（Codex）
https://api.sudocode.cyou/v1
▸备用 URL (直连)
Base API URL（Claude Code）
https://api.sudorelay.com
OpenAI 兼容 URL（Codex）
https://api.sudorelay.com/v1

开始之前

1

登录 SudoCode 控制台。

2

进入 API Key 页面，创建一个新的 Key。

3

在下方环境变量或配置文件中把 sk-你的 SudoCode API Key 替换成真实 Key。

4

修改配置后重新打开终端或重启 Claude Code / Codex。

Claude Code

适合使用 Claude 系列模型进行项目开发。配置后，在项目目录执行 claude 即可进入交互式编码环境。

环境变量适合当前终端快速验证；settings.json 适合长期使用。修改后请重启 Claude Code。

1打开 Windows PowerShell
1.点击开始菜单
2.搜索 PowerShell
3.点击打开 Windows PowerShell 或 Terminal
2安装 Node.js LTS
winget install OpenJS.NodeJS.LTS
3安装 Claude Code
npm install -g @anthropic-ai/claude-code
4写入用户环境变量
setx ANTHROPIC_AUTH_TOKEN "sk-你的 SudoCode API Key"
setx ANTHROPIC_BASE_URL "https://api.sudocode.cyou"
5可选：写入当前 PowerShell 会话
$env:ANTHROPIC_AUTH_TOKEN="sk-你的 SudoCode API Key"
$env:ANTHROPIC_BASE_URL="https://api.sudocode.cyou"
6可选：写入持久配置
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
@'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 SudoCode API Key",
    "ANTHROPIC_BASE_URL": "https://api.sudocode.cyou"
  }
}
'@ | Set-Content "$env:USERPROFILE\.claude\settings.json"
7启动或重启 Claude Code
claude

Codex

适合使用 GPT 系列模型进行代码生成、修改和审查。配置后，在项目目录执行 codex 即可开始使用。

Codex 以 config.toml 定义 provider，API Key 继续通过 OPENAI_API_KEY 环境变量读取。修改后请重启 Codex。

1打开 Windows PowerShell
1.点击开始菜单
2.搜索 PowerShell
3.点击打开 Windows PowerShell 或 Terminal
2安装 Node.js LTS
winget install OpenJS.NodeJS.LTS
3安装 Codex CLI
npm install -g @openai/codex
4推荐：写入持久配置
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
@'
model = "gpt-5.5"
model_provider = "sudocode"
model_reasoning_effort = "xhigh"

[model_providers.sudocode]
name = "OpenAI"
base_url = "https://api.sudocode.cyou/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
'@ | Set-Content "$env:USERPROFILE\.codex\config.toml"
5推荐：持久写入 API Key
setx OPENAI_API_KEY "sk-你的 SudoCode API Key"
6可选：写入当前 PowerShell 会话
$env:OPENAI_API_KEY="sk-你的 SudoCode API Key"
7启动或重启 Codex
codex

更多 SudoCode 接入文档

Claude Code 配置

单独查看 Claude Code 的环境变量、Base URL 和排查步骤。

Codex 配置

单独查看 Codex 的 config.toml、Responses 接口和 Key 配置。

MCP 余额查询

查看 Codex、Claude Code、Hermes 的 SudoCode 余额 MCP 接入方式。

image-2 配置

查看图片生成、图片编辑、SDK 和 curl 的调用示例。

SudoCode 常见问题

查看 API Base、模型价格、配置生效和常见使用问题。

常见检查

Claude Code 使用 Anthropic 风格接口，Base URL 填 https://api.sudocode.cyou。

Claude Code 持久配置路径是 macOS / Linux 的 ~/.claude/settings.json，以及 Windows 的 %USERPROFILE%\.claude\settings.json。

Codex 使用 OpenAI Responses 接口，配置文件 ~/.codex/config.toml 或 %USERPROFILE%\.codex\config.toml 里的 base_url 填 https://api.sudocode.cyou/v1。

Codex 的真实 Key 建议只放在 OPENAI_API_KEY 环境变量中，不写进 config.toml。

配置修改后需要重新打开终端，或完全退出并重启对应 CLI，正在运行的 Claude Code / Codex 不会自动读取新配置。

Windows 提示 npm 无法识别时，先重新打开 PowerShell，再检查 node -v、npm -v、where.exe npm；必要时确认 C:\Program Files\nodejs 在 PATH 中。

Linux 全局 npm 安装出现 EACCES 时，临时方案是 sudo npm install -g，长期方案是把 npm prefix 改到用户目录。

排查 Base URL 时注意 Claude Code 不带 /v1，Codex 和 OpenAI 兼容客户端带 /v1。