layout, hero, features
| layout |
hero |
features |
| home |
| name |
text |
tagline |
actions |
| XCodeCLI |
全能 AI 开发配置中心 |
统一管理 Claude Code / Gemini CLI / Codex 及 Cherry Studio 配置 |
| theme |
text |
link |
| brand |
快速开始 |
/guide/ |
|
| theme |
text |
link |
| alt |
Cherry Studio 教程 |
/cherry-studio-nanobana |
|
|
|
| icon |
title |
details |
| 🚀 |
CLI 一键配置 |
一行命令自动配置 Claude Code、Gemini CLI 和 Codex |
|
| icon |
title |
details |
| 🍒 |
Cherry Studio 支持 |
完美适配 Cherry Studio，支持 Gemini 系列模型可视化交互 |
|
| icon |
title |
details |
| 🔒 |
安全可靠 |
自动备份现有配置，本地化管理 API 密钥 |
|
|
<script setup>
import { ref } from 'vue'
const activeTab = ref('bash')
const copied = ref(false)
const commands = {
bash: `API_KEY='你的密钥' bash -c "$(curl -fsSL
https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/setup.sh)"`,
powershell: `$key='你的密钥'; iex (irm
https://gitea.sususu.cf/sususu/xcodecli-shells/raw/branch/main/setup.ps1)`
}
function copyCommand() {
navigator.clipboard.writeText(commands[activeTab.value])
copied.value = true
setTimeout(() => copied.value = false, 2000)
}
</script>
1. CLI 工具一键配置
适用于 Claude Code、Gemini CLI 和 Codex 的自动化配置。
🍎/🐧 macOS / Linux
🪟 Windows
{{ commands[activeTab] }}
{{ copied ? '已复制' : '复制命令' }}
💡 提示：运行前请将命令中的 你的密钥 替换为实际 API Key。配置完成后请重启终端，否则工具可能无法读取 API 密钥。
2. Cherry Studio 配置
在 Cherry Studio 中使用 XCodeCLI 服务，享受可视化的对话体验。
::: tip 💡 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 |
::: tip 📝 详细教程
查看完整的 Cherry Studio 图文配置指南
:::
2.5 API 分组说明
XCodeCLI 提供多个 API 分组，适用于不同的使用场景。
::: warning 🔑 分组区别
- cc2api 分组（推荐）：提供 Claude 系列模型，无客户端限制，可自由搭配各种客户端
- ccmax 分组：提供 Claude 系列模型，但只能用于 Claude Code
:::
cc2api — 推荐使用
cc2api 分组包含 Claude 系列模型，无客户端限制。推荐搭配以下工具：
| 客户端 |
类型 |
说明 |
| OpenCode |
终端 AI 编码代理 |
开源，支持 75+ LLM 供应商，可作为 Claude Code 的替代方案。支持终端、桌面端和 IDE 插件 |
| OpenClaw |
个人 AI 助手 |
开源，连接 WhatsApp / Telegram / Slack 等消息平台，支持浏览器自动化、邮件、日历等操作 |
| Cherry Studio |
可视化对话客户端 |
支持多服务商集成，详见 配置教程 |
::: tip 💡 GPT 系列模型
GPT 系列模型推荐使用 v1/responses 端点以获得最佳效果。
:::
ccmax — 仅限 Claude Code
ccmax 分组同样提供 Claude 系列模型，但只能用于 Claude Code，不支持其他客户端。如果你使用 Claude Code 且 cc2api 遇到兼容性问题，可尝试切换到 ccmax。
3. 参考信息
CLI 配置文件位置
| 工具 |
配置文件 |
格式 |
| Claude Code |
~/.claude/settings.json |
JSON |
| Gemini CLI |
~/.gemini/.env |
ENV |
| Codex |
~/.codex/config.toml |
TOML |
API 端点
脚本会自动测试以下端点，选择第一个可用的：
https://api2.xcodecli.com (主要)https://api.xcodecli.com (备用)
<style>
.setup-section {
margin: 3rem auto;
max-width: 960px;
padding: 0 1.5rem;
}
.setup-section h2 {
border-top: none;
font-size: 1.8rem;
font-weight: 700;
margin-bottom: 1rem;
display: flex;
align-items: center;
gap: 0.5rem;
}
.desc {
color: var(--vp-c-text-2);
font-size: 1.1rem;
margin-bottom: 1.5rem;
}
/* Install Card Styles */
.install-card {
background: var(--vp-c-bg-soft);
border: 1px solid var(--vp-c-divider);
border-radius: 12px;
overflow: hidden;
box-shadow: 0 4px 24px rgba(0, 0, 0, 0.05);
margin-bottom: 1rem;
}
.tabs {
display: flex;
background: var(--vp-c-bg-mute);
border-bottom: 1px solid var(--vp-c-divider);
}
.tabs button {
flex: 1;
padding: 1rem;
font-size: 0.95rem;
font-weight: 600;
color: var(--vp-c-text-2);
background: transparent;
border: none;
cursor: pointer;
transition: color 0.2s, background-color 0.2s;
display: flex;
align-items: center;
justify-content: center;
gap: 8px;
}
.tabs button:hover {
color: var(--vp-c-text-1);
background-color: var(--vp-c-bg-soft);
}
.tabs button.active {
color: var(--vp-c-brand);
background: var(--vp-c-bg-soft);
box-shadow: inset 0 -2px 0 var(--vp-c-brand);
}
.code-block-wrapper {
position: relative;
padding: 1.5rem;
text-align: left;
display: flex;
gap: 1rem;
align-items: center;
}
.code-block {
flex: 1;
font-family: var(--vp-font-family-mono);
font-size: 0.9rem;
color: var(--vp-c-text-1);
overflow-x: auto;
white-space: pre;
padding-right: 0.5rem;
scrollbar-width: thin;
}
.code-block::-webkit-scrollbar {
height: 6px;
}
.code-block::-webkit-scrollbar-thumb {
background-color: var(--vp-c-divider);
border-radius: 3px;
}
.copy-btn {
flex-shrink: 0;
padding: 0.5rem 1rem;
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
background: var(--vp-c-bg);
color: var(--vp-c-text-1);
font-size: 0.85rem;
font-weight: 500;
cursor: pointer;
transition: all 0.2s;
}
.copy-btn:hover {
border-color: var(--vp-c-brand);
color: var(--vp-c-brand);
}
.copy-btn.copied {
border-color: var(--vp-c-green);
color: var(--vp-c-green);
background-color: var(--vp-c-bg-mute);
}
.tip {
font-size: 0.9rem;
color: var(--vp-c-text-2);
}
.tip code {
color: var(--vp-c-brand);
background-color: var(--vp-c-bg-mute);
padding: 0.2em 0.4em;
border-radius: 4px;
}
</style>
sususu98
b07c61aa9d