按你的当前状态选择
直接命中，不需要从头读
什么都没安装
先装一个入口工具
只想最快开始，用 CC Switch 管理；想直接写代码，用 Codex；偏终端工作流，用 OpenCode。
- 先去令牌页复制 API Key
- 选择 CC Switch / Codex / OpenCode 其中一个
- 按下面对应配置填 Base URL 和 Key
已有 CC Switch
从令牌页一键导入
适合同时用多个工具。少手改配置，后续在 CC Switch 里选择 Euzhi 即可。
- 打开 Euzhi 令牌页面
- 在令牌右侧选择 CC Switch / codex
- 确认导入后选择 Euzhi
已有 Codex
只补 Key 和配置
适合已经装好 Codex CLI / Codex App 的用户。核心是环境变量和 config.toml。
- 设置
OPENAI_API_KEY - 复制下面的 Codex 配置
- 运行
codex或codex app
已有 OpenCode
复制 opencode.json
适合终端党。复制下面配置，Key 继续放环境变量。
- 设置
OPENAI_API_KEY - 复制下面的
opencode.json - 选择
euzhi/gpt-5.5
只接 API
按 OpenAI 兼容接口接
适合后端、脚本、工作流平台。Base URL 填到 /v1，Authorization 带 Bearer Key。
- 对话/多模态走 Responses 接口
- 图片生成不要走聊天接口
- 先用 curl 测通再接业务
只想生成图片
直接用 Image2 Demo
适合先验证 Key、效果和耗时。下面有两个输入框：API Key + 图片描述。
- 文生图走
/v1/images/generations - 有参考图走
/v1/images/edits - 模型固定
gpt-image-2
CC Switch：推荐给多工具用户
安装一次，后面切换更省心CC Switch最短路径
1. 安装 CC Switch https://github.com/farion1231/cc-switch/releases 2. 打开 Euzhi 令牌页面 https://api.euzhi.com/console/token 3. 找到要使用的令牌 点击右侧聊天应用入口，选择「CC Switch」对应工具 4. 在 CC Switch 中确认导入 5. 在 CC Switch 里选择 Euzhi
Codex：推荐给代码任务
脚本不是必须，手动配置更稳TerminalKey + 配置目录
echo 'export OPENAI_API_KEY="sk-你的令牌"' >> ~/.zshrc source ~/.zshrc mkdir -p ~/.codex nano ~/.codex/config.toml
PowerShellKey + 配置目录
setx OPENAI_API_KEY "sk-你的令牌" New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" notepad "$env:USERPROFILE\.codex\config.toml"
config.toml核心配置
model = "gpt-5.5" model_provider = "euzhi" [model_providers.euzhi] name = "Euzhi" base_url = "https://api.euzhi.com/v1" env_key = "OPENAI_API_KEY" wire_api = "responses"
这里的
model_provider 是 Codex 固定配置字段，整段复制，改好 Key 后即可使用。
启动 Codex配置完成后再执行
codex # 如果要打开桌面应用 codex app
脚本闪退怎么办
脚本只是兜底，不是必经步骤
有些电脑双击
.bat 或 .command 会一闪而过，看不到报错。推荐复制下面命令到终端运行，窗口不会自动关闭。
Terminal脚本版
cd ~/Downloads xattr -d com.apple.quarantine ./setup-codex-macos.command 2>/dev/null || true bash ./setup-codex-macos.command
CMD脚本版
cd %USERPROFILE%\Downloads cmd /k setup-codex-windows.bat
只接 API：最小请求
适合后端、脚本、自动化平台Responses对话/多模态请求
curl https://api.euzhi.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"input": "用三句话解释 Euzhi 怎么接入",
"stream": true,
"max_output_tokens": 800,
"reasoning": {
"effort": "medium"
}
}'
常见问题
只保留高频坑位提示 command not found: codex
Codex CLI 没装好，先安装 Codex，再执行 codex --version 验证。
Codex 能打开但请求失败
检查 OPENAI_API_KEY 是否生效，config.toml 是否保存，Base URL 是否只写到 /v1。
调用无权限
令牌没有开启目标模型，或账户余额不足，先去控制台确认令牌和余额。
Image2 报错
确认模型是 gpt-image-2，文生图走 /v1/images/generations，参考图走 /v1/images/edits。
OpenCode
支持文本，也支持上传图片opencode.json图片输入版
{
"$schema": "https://opencode.ai/config.json",
"model": "euzhi/gpt-5.5",
"provider": {
"euzhi": {
"npm": "@ai-sdk/openai",
"name": "Euzhi",
"options": {
"baseURL": "https://api.euzhi.com/v1",
"apiKey": "{env:OPENAI_API_KEY}"
},
"models": {
"gpt-5.5": {
"name": "GPT-5.5",
"reasoning": true,
"limit": {
"context": 1050000,
"output": 128000
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
},
"options": {
"reasoningEffort": "medium"
}
}
}
}
}
}
Image2 图片生成
复制 API Key，输入描述，直接生成图片
Live Demo · gpt-image-2
用一句话生成一张 Image2 图片
API Key 只保留在当前浏览器输入框，不会写入页面存储。图片生成通常需要 60-120 秒，请耐心等待进度完成。
如果上传参考图，就会自动切到参考图编辑；没有参考图时，保持正常文生图流程。
准备就绪，填写 API Key 和图片描述后开始生成。
生成结果会显示在这里
建议先用 1024x1024 测试，确认 Key 可用后再接入后端。
curl同等后端请求
curl https://api.euzhi.com/v1/images/generations \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一张极简科技感海报，蓝绿色渐变背景，主体是发光的 AI 图片工作台",
"size": "1024x1024",
"quality": "medium",
"n": 1
}'