AI精品店

Appearance

CLI 配置教程 ​

手动配置 Claude Code、Codex、Gemini CLI 工具。

推荐使用 CC-Switch

如果你不熟悉命令行或配置文件编辑，强烈建议使用 CC-Switch 进行配置，更简单快捷！

本页面适合：

  • 喜欢手动配置的进阶用户
  • CC-Switch 不适用的特殊场景
  • 需要深度定制配置的用户

通用步骤：环境检查 ​

在配置任何 CLI 前，先检查运行环境。

（1）确认 Node.js 已安装 ​

打开终端，运行：

bash
node --version
npm --version

正常输出：

如果提示「命令未找到」，说明未安装 Node.js，请参考 code cli 客户端下载 安装。

（2）安装 CLI 工具 ​

根据需要，安装对应的 CLI：

bash
# Claude Code
npm install -g @anthropic-ai/claude-code@latest

# Codex
npm install -g @openai/codex@latest

# Gemini CLI
npm install -g @google/gemini-cli@latest

（3）验证安装成功 ​

运行对应命令，确保安装成功：

Claude Code：

bash
claude

Codex：

bash
codex

Gemini：

bash
gemini

如果出现欢迎界面或提示输入，说明安装成功。

重要

首次运行会在用户目录下生成配置文件夹，这是后续配置的基础，请务必执行此步骤！

Claude Code 配置 ​

配置文件位置 ​

Windows：

%USERPROFILE%\.claude\

macOS / Linux：

~/.claude/

手动配置步骤 ​

1. 打开配置目录 ​

Windows：

  • 按 Win+R，输入 %USERPROFILE%\.claude，回车

macOS：

  • 在访达按 Command+Shift+G
  • 输入 ~/.claude，回车

2. 编辑 auth.json ​

如果目录中没有 auth.json，手动创建。

文件内容：

json
{
  "api.xbai.top": {
    "apiKey": "sk-你的API令牌"
  }
}

重要

令牌必须是 CC 分组 的！

3. 编辑 config.json（可选） ​

创建或编辑 config.json，配置默认 API：

json
{
  "primaryApiKey": "api.xbai.top"
}

这样 Claude Code 会默认使用 api.xbai.top 的配置。

4. 测试配置 ​

打开终端，运行：

bash
claude

能正常对话即表示配置成功！

Codex 配置 ​

配置文件位置 ​

Windows：

%USERPROFILE%\.codex\

macOS / Linux：

~/.codex/

手动配置步骤 ​

1. 打开配置目录 ​

Windows：

  • 按 Win+R，输入 %USERPROFILE%\.codex，回车

macOS：

  • 访达按 Command+Shift+G，输入 ~/.codex

2. 编辑 auth.json ​

创建或编辑 auth.json：

json
{
  "apiKey": "sk-你的API令牌"
}

重要

令牌必须是 Codex 分组 的！

3. 编辑 config.toml ​

创建或编辑 config.toml：

toml
model_provider = "xbai"
model = "gpt-5.1-codex"

[model_providers.xbai]
name = "xbai"
base_url = "https://api.xbai.top/v1"
wire_api = "responses"
requires_openai_auth = true

4. 测试配置 ​

运行：

bash
codex

能正常使用即配置成功！

Gemini 配置 ​

配置文件位置 ​

Windows：

%USERPROFILE%\.gemini\

macOS / Linux：

~/.gemini/

手动配置步骤 ​

1. 打开配置目录 ​

同上述方法打开对应目录。

2. 编辑 config.json ​

创建或编辑 config.json：

json
{
  "apiKey": "sk-你的API令牌",
  "baseUrl": "https://api.xbai.top/gemini/v1"
}

重要

令牌必须是 Gemini 分组 的！

3. 测试配置 ​

运行：

bash
gemini

能正常对话即配置成功！

常见问题 ​

❓ 找不到配置文件夹 ​

原因：未运行过 CLI 工具

解决：先运行一次对应的 CLI（claude / codex / gemini），会自动创建配置目录

❓ 提示「模型不存在」 ​

原因：令牌分组选择错误

解决：

  • Claude Code 必须用 CC 分组令牌
  • Codex 必须用 Codex 分组令牌
  • Gemini 必须用 Gemini 分组令牌

查看 模型分组介绍 确认分组。

❓ 无法连接到服务器 ​

检查步骤：

  1. 确认网络正常，能访问 https://api.xbai.top
  2. 确认 API Key 正确且有额度
  3. 确认 base_url 配置正确（注意末尾不要有多余的 /）
  4. 查看 客服支持 获取帮助

❓ VS Code 插件如何配置？ ​

Claude Code 插件：

  1. 确保 CLI 已正确配置（参考上述步骤）
  2. 编辑 ~/.claude/config.json，添加：
json
{
  "primaryApiKey": "api.xbai.top"
}
  1. 重启 VS Code

Cline / Roo Code 插件：

在插件设置中：

  • API Provider：选择 "OpenAI-compatible"
  • Base URL：https://api.xbai.top/v1
  • API Key：你的令牌
  • Model：根据分组选择对应模型

高级配置 ​

自定义模型 ​

在 config.toml 或 config.json 中指定模型：

Codex：

toml
model = "你想使用的模型名"

Gemini：

json
{
  "defaultModel": "gemini-pro"
}

可用模型列表请查看控制台「模型广场」。

设置代理（可选） ​

如果网络环境需要代理：

环境变量方式：

bash
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

配置文件方式（Codex）：

toml
[network]
proxy = "http://127.0.0.1:7890"

更简单的方式 ​

还是觉得手动配置太复杂？

👉 使用 CC-Switch 一键完成配置！

最后更新：2025-02-01