🚀
CLI 一键配置
一行命令自动配置 Claude Code、Gemini CLI 和 Codex
XCodeCLI全能 AI 开发配置中心
统一管理 Claude Code / Gemini CLI / Codex，支持 OpenClaw 与 Cherry Studio
Skip to content
1. CLI 工具一键配置
适用于 Claude Code、Gemini CLI 和 Codex 的自动化配置。
API_KEY='你的密钥' bash -c "$(curl -fsSL https://docs.xcodecli.com/scripts/setup.sh)"💡 提示：运行前请将命令中的 你的密钥 替换为实际 API Key。配置完成后请重启终端，否则工具可能无法读取 API 密钥。
2. Cherry Studio 配置
在 Cherry Studio 中使用 XCodeCLI 服务，享受可视化的对话体验。
💡 Cherry Studio 模型兼容性
Cherry Studio 支持所有模型，但注意 ccmax 分组的 Claude 模型不可用（ccmax 只能用于 Claude Code）。Claude 模型请使用 cc2api 分组。
配置参数
请在 Cherry Studio 设置中添加 自定义提供商：
| 配置项 | 值 | 说明 |
|---|---|---|
| 提供商类型 | Gemini | 必选 (不要选 OpenAI) |
| API 密钥 | sk-... | 你的 XCodeCLI 密钥 |
| API 地址 | https://api2.xcodecli.com | Base URL |
📝 详细教程
查看完整的 Cherry Studio 图文配置指南
2.5 API 分组说明
XCodeCLI 提供多个 API 分组，适用于不同的使用场景。
🔑 分组区别
- codex 分组（Codex 推荐）：提供 GPT / Codex 系列模型，适用于 Codex CLI 和 Codex App
codex — Codex 推荐使用
Codex CLI 和 Codex App 推荐使用 codex 分组，不再推荐使用 cc2api 分组。GPT / Codex 系列模型推荐使用 v1/responses 端点以获得最佳效果。
cc2api — Claude/OpenAI 兼容客户端
cc2api 分组包含 Claude 系列模型，推荐搭配以下工具：
| 客户端 | 类型 | 说明 |
|---|---|---|
| OpenCode | 终端 AI 编码代理 | 开源，支持 75+ LLM 供应商，可作为 Claude Code 的替代方案。支持终端、桌面端和 IDE 插件 |
| OpenClaw | 个人 AI 助手 | 开源，连接 WhatsApp / Telegram / Slack 等消息平台，支持浏览器自动化、邮件、日历等操作 |
| Cherry Studio | 可视化对话客户端 | 支持多服务商集成，详见 配置教程 |
💡 GPT 系列模型
GPT / Codex 系列模型请使用 codex 分组和 v1/responses 端点。
ccmax — 仅限 Claude Code
ccmax 分组同样提供 Claude 系列模型，但只能用于 Claude Code，不支持其他客户端。如果你使用 Claude Code 且 cc2api 遇到兼容性问题，可尝试切换到 ccmax。