🔥 Claude + Codex + Gemini + OpenClaw

支持 Claude Code、Codex、Gemini CLI、OpenClaw 国内直连与配置，官方原版体验

🛒 购买渠道 & 售后服务

一号店铺

二号店铺

售后服务

为什么选我？

✅ 双平台 - 一站搞定两大 AI 编程神器

✅ 稳定 - 告别 500/422/402，专线直连

✅ 低价 - 同等服务价格最优

✅ 无限制 - 不限 key、设备

✅ 售后好 - 服务原因不可用按量退

🚨 重要说明

Claude Code / Gemini CLI 都有一定上手门槛。我只负责你在官方客户端能用上，第三方包装客户端什么的需要自行研究。

🤔 常遇问题

5. 安装与使用教程

💡 推荐使用 WSL 或 Git Bash

Claude Code 在 Windows 请使用 WSL 去安装操作使用，问题会少不少。再不济也要用 Git Bash 去调用 Claude Code。兼容最差的就是 PowerShell，经常文件锁定写入不了（error write file）。遇到问题多问 AI！

💡 推荐使用 Windows Terminal

强烈建议使用 Windows Terminal，支持多标签、emoji 和中文显示。CMD 是上古遗物，用它必出问题！

GitHub 下载

0 ⚠️ 前置要求：安装 Git

Claude Code 需要 Git 才能运行。如果启动时遇到以下错误：

Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win). If installed but not in PATH, set environment variable pointing to your bash.exe, similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

请先安装 Git：

官方下载国内加速下载

⚠️ 必须用 PowerShell 或 Windows Terminal！

PowerShell

CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

验证安装

⚠️ 必须用 PowerShell 或 Windows Terminal！

PowerShell

git --version

⭐ 原生安装（推荐）

⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

✅ 无需 Node.js，自动后台更新，官方推荐
✅ 自动后台更新，始终保持最新版本
✅ 避免 npm 权限问题

PowerShell (管理员)

irm https://claude.ai/install.ps1 | iex

如果你更习惯使用 WinGet 包管理器：

PowerShell

winget install Anthropic.ClaudeCode

更新到最新版本：

PowerShell

winget upgrade Anthropic.ClaudeCode

由于网络环境原因，直连 Anthropic API 可能会失败或超时。

解决方案：

推荐配置下方的环境变量使用中转服务（稳定、高速）。
或者确保你的终端走了系统代理（科学上网）。

⚠️ 官方推荐原生安装方式！ npm 安装已被标记为弃用，但对于网络受限需要使用国内镜像的用户仍可使用。

第一步：安装 Node.js 18+

Claude Code 需要 Node.js 18 或更高版本。选择以下任一方式安装：

访问 Node.js 官网，下载 LTS（长期支持）版本并安装。

安装完成后，验证安装：

⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

node --version
npm --version

nvm-windows 可以方便地安装和切换不同版本的 Node.js：

访问 nvm-windows Releases
下载最新版的 nvm-setup.exe 并安装
安装完成后，打开新的 PowerShell 窗口执行：

⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

# 查看可用版本
nvm list available

# 安装最新 LTS 版本
nvm install lts

# 使用该版本
nvm use lts

# 验证安装
node --version

使用 Chocolatey：

⚠️ 必须用管理员权限的 PowerShell！
右键开始菜单 → 选择「终端（管理员）」或「PowerShell（管理员）」

PowerShell (管理员)

choco install nodejs-lts

使用 Scoop：

⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

scoop install nodejs-lts

验证安装：

PowerShell

node --version
npm --version

第二步：使用 npm 全局安装 Claude Code

⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

# 直接安装（需要能访问 npm 官方源）
npm install -g @anthropic-ai/claude-code

# 如果网络不好，可以使用国内镜像
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

💡 提示：使用 --registry 参数可以临时指定国内镜像源，解决网络问题。

如果你之前用 npm 安装过，建议迁移到原生版本：

PowerShell

# 1. 卸载 npm 版本
npm uninstall -g @anthropic-ai/claude-code

# 2. 执行原生安装
irm https://claude.ai/install.ps1 | iex

如果需要安装特定版本（仅限 npm 方式）：

PowerShell

npm install -g @anthropic-ai/claude-code@0.2.9

将 0.2.9 替换为你需要的版本号。

验证安装

PowerShell

claude --version

显示版本号说明安装成功！

❓ 提示 .local\bin 不在 PATH 中？

原生安装后如果提示路径不在 PATH 中，执行以下命令添加：

系统级别（需管理员权限）：

⚠️ 按 Win+X → 选择「终端(管理员)」或「PowerShell(管理员)」

系统级别：

PowerShell (管理员)粘贴直接执行

$p="$env:USERPROFILE\.local\bin"; if([Environment]::GetEnvironmentVariable("Path","Machine") -notlike "*$p*"){[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path","Machine")+";$p","Machine"); "已添加 - 请重启终端生效"}else{"已存在，无需操作"}

用户级别：(群主不推荐别问按我说的做)

PowerShell

$p="$env:USERPROFILE\.local\bin"; if([Environment]::GetEnvironmentVariable("Path","User") -notlike "*$p*"){[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path","User")+";$p","User"); "已添加 - 请重启终端生效"}else{"已存在，无需操作"}

设置环境变量

配置连接到中转服务。

如果之前设置过 ANTHROPIC_BASE_URL 或 ANTHROPIC_API_KEY，请先清除，否则可能冲突。

PowerShell (管理员)

# 检查现有变量
Get-ChildItem Env:ANTHROPIC_*

# 删除冲突变量 (根据实际显示结果修改)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, [System.EnvironmentVariableTarget]::Machine)

永久设置

系统级别（需管理员权限）：

⚠️ 需管理员权限打开 PowerShell

PowerShell (管理员)

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cc.sub.258000.sbs", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk_xxxxxxxxx", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "3000000", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", [System.EnvironmentVariableTarget]::Machine)

用户级别：(群主不推荐别问按我说的做)

PowerShell

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cc.sub.258000.sbs", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk_xxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "3000000", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", [System.EnvironmentVariableTarget]::User)

临时设置 (群主不推荐别问按我说的做)：

PowerShell

$env:ANTHROPIC_BASE_URL = "https://cc.sub.258000.sbs"
$env:ANTHROPIC_AUTH_TOKEN = "sk_xxxxxxxxx"
$env:API_TIMEOUT_MS = "3000000"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

💡 临时设置只在当前窗口有效，关闭即失效。

💡 sk_xxxxxxxxx 请替换为官网api密钥中所申请的密钥！

验证环境变量

设置完成后，重新打开终端并执行以下命令检查：

PowerShell

Get-ChildItem Env:ANTHROPIC_*

如果不再使用本服务，可以删除相关环境变量：

PowerShell (管理员)

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", $null, [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", $null, [System.EnvironmentVariableTarget]::Machine)

开始使用

PowerShell

# 进入项目目录
cd C:\path\to\your\project

# 启动
claude

⭐ 原生安装（推荐）

✅ 无需安装 Node.js 18+
✅ 自动后台更新，始终保持最新版本
✅ 避免 npm 权限问题

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

curl -fsSL https://claude.ai/install.sh | bash

如果你更习惯使用 Homebrew：

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

brew install --cask claude-code

⚠️ Homebrew 安装不会自动更新，需定期运行 brew upgrade claude-code

由于网络环境原因，直连 Anthropic API 可能会失败或超时。

解决方案：

推荐配置下方的环境变量使用中转服务（稳定、高速）。
或者确保你的终端走了系统代理（科学上网）。

⚠️ 官方已标记为弃用！ 推荐使用上方的原生安装方式。

如果你坚持要用 npm：

1. 安装 Node.js (v18+)

💡 已安装？运行 node --version 验证。

使用 Homebrew

Terminal

brew install node

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc  # 或 ~/.bashrc
nvm install --lts

使用 gitee 镜像：

Terminal

curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash
source ~/.zshrc  # 或 ~/.bashrc

# 使用淘宝镜像下载 Node
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install --lts

验证 Node.js 安装

安装完成后，验证 Node.js 和 npm 是否正确安装：

Terminal

node --version
npm --version

✅ 应显示 Node.js v18+ 和 npm 版本号，确认后再继续下一步。

2. 安装 Claude Code

Terminal

npm install -g @anthropic-ai/claude-code

⚠️ 如果遇到权限错误 (EACCES)，请使用 sudo npm install -g @anthropic-ai/claude-code 或使用 nvm 管理 Node 版本。

3. 验证 Claude Code 安装

Terminal

claude --version

✅ 显示版本号（如 1.0.x）说明安装成功！

如果你之前用 npm 安装过，建议迁移到原生版本：

Terminal

# 1. 卸载 npm 版本
npm uninstall -g @anthropic-ai/claude-code

# 2. 执行原生安装
curl -fsSL https://claude.ai/install.sh | sh

如果需要安装特定版本（仅限 npm 方式）：

Terminal

npm install -g @anthropic-ai/claude-code@0.2.9

将 0.2.9 替换为你需要的版本号。

验证安装

Terminal

claude --version

显示版本号说明安装成功！

设置环境变量

配置连接到中转服务。

配置连接到中转服务。settings.json 中的 env 优先级高于系统环境变量，需先清理。

检查配置文件：

🖥️ 在终端中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

cat ~/.claude/settings.json

检查环境变量：

🖥️ 在终端中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

echo "BASE: $ANTHROPIC_BASE_URL" && echo "TOKEN: $ANTHROPIC_AUTH_TOKEN"

清理旧配置

查看当前 shell：echo $SHELL

Zsh（编辑 ~/.zshrc 删除相关行）：

🖥️ 在终端中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

# Delete lines containing ANTHROPIC_
sed -i '' '/ANTHROPIC_/d' ~/.zshrc && source ~/.zshrc

Bash（编辑 ~/.bashrc 删除相关行）：

🖥️ 在终端中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

# Delete lines containing ANTHROPIC_
sed -i '' '/ANTHROPIC_/d' ~/.bashrc && source ~/.bashrc

💡 如果 settings.json 中有 env 包含 ANTHROPIC_BASE_URL，需删除或修改。

永久设置

Zsh (~/.zshrc)：

Terminal

cat >> ~/.zshrc << 'EOF'
export ANTHROPIC_BASE_URL="https://cc.sub.258000.sbs"
export ANTHROPIC_AUTH_TOKEN="sk_xxxxxxxxx"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
EOF
source ~/.zshrc

Bash (~/.bashrc)：

Terminal

cat >> ~/.bashrc << 'EOF'
export ANTHROPIC_BASE_URL="https://cc.sub.258000.sbs"
export ANTHROPIC_AUTH_TOKEN="sk_xxxxxxxxx"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
EOF
source ~/.bashrc

临时设置（当前会话有效）：

Terminal

export ANTHROPIC_BASE_URL="https://cc.sub.258000.sbs"
export ANTHROPIC_AUTH_TOKEN="sk_xxxxxxxxx"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

💡 临时设置只在当前终端窗口有效，关闭即失效。

💡 sk_xxxxxxxxx 请替换为官网api密钥中所申请的密钥！

验证环境变量

设置完成后，重新打开终端并执行以下命令检查：

Terminal

env | grep ANTHROPIC

如果不再使用本服务，编辑配置文件删除相关行：

Terminal

# Zsh 用户
nano ~/.zshrc
# 删除包含 ANTHROPIC_ 和 API_TIMEOUT_MS 和 CLAUDE_CODE_DISABLE 的行

# Bash 用户
nano ~/.bashrc
# 删除包含 ANTHROPIC_ 和 API_TIMEOUT_MS 和 CLAUDE_CODE_DISABLE 的行

# 重新加载配置
source ~/.zshrc  # 或 source ~/.bashrc

开始使用

Terminal

# 进入项目目录
cd ~/projects/your-project

# 启动
claude

💡 本教程同时适用于原生 Linux 和 Windows WSL（Windows Subsystem for Linux）环境。

⭐ 原生安装（推荐）

✅ 无需安装 Node.js 18+
✅ 自动后台更新，始终保持最新版本
✅ 避免 npm 权限问题

Terminal

curl -fsSL https://claude.ai/install.sh | sh

由于网络环境原因，直连 Anthropic API 可能会失败或超时。

解决方案：

推荐配置下方的环境变量使用中转服务（稳定、高速）。
或者确保你的终端走了系统代理（科学上网）。

⚠️ 官方已标记为弃用！ 推荐使用上方的原生安装方式。

如果你坚持要用 npm：

1. 安装 Node.js (v18+)

💡 已安装？运行 node --version 验证。

Ubuntu/Debian

Terminal

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - &&\
sudo apt-get install -y nodejs

Fedora/RHEL

Terminal

sudo dnf install nodejs

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

使用 gitee 镜像：

Terminal

curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash
source ~/.bashrc

# 使用淘宝镜像下载 Node
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install --lts

2. 安装 Claude Code

Terminal

sudo npm install -g @anthropic-ai/claude-code

⚠️ 如果使用 nvm 安装的 Node，不需要 sudo。

如果你之前用 npm 安装过，建议迁移到原生版本：

Terminal

# 1. 卸载 npm 版本
sudo npm uninstall -g @anthropic-ai/claude-code

# 2. 执行原生安装
curl -fsSL https://claude.ai/install.sh | sh

如果需要安装特定版本（仅限 npm 方式）：

Terminal

sudo npm install -g @anthropic-ai/claude-code@0.2.9

将 0.2.9 替换为你需要的版本号。

验证安装

Terminal

claude --version

显示版本号说明安装成功！

原生安装后如果提示路径不在 PATH 中，执行以下命令添加：

Terminal

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Zsh 用户请将 .bashrc 改为 .zshrc

设置环境变量

配置连接到中转服务。

如果之前设置过 ANTHROPIC_BASE_URL 或 ANTHROPIC_API_KEY，请先清除，否则可能冲突。

Terminal

# 检查现有变量
env | grep ANTHROPIC

# 如果有旧配置，编辑 shell 配置文件删除相关行
nano ~/.bashrc  # 或 ~/.zshrc

永久设置

Bash (~/.bashrc)：

Terminal

cat >> ~/.bashrc << 'EOF'
export ANTHROPIC_BASE_URL="https://cc.sub.258000.sbs"
export ANTHROPIC_AUTH_TOKEN="sk_xxxxxxxxx"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
EOF
source ~/.bashrc

Zsh (~/.zshrc)：

Terminal

cat >> ~/.zshrc << 'EOF'
export ANTHROPIC_BASE_URL="https://cc.sub.258000.sbs"
export ANTHROPIC_AUTH_TOKEN="sk_xxxxxxxxx"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
EOF
source ~/.zshrc

临时设置（当前会话有效）：

Terminal

export ANTHROPIC_BASE_URL="https://cc.sub.258000.sbs"
export ANTHROPIC_AUTH_TOKEN="sk_xxxxxxxxx"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

💡 临时设置只在当前终端窗口有效，关闭即失效。

💡 sk_xxxxxxxxx 请替换为官网api密钥中所申请的密钥！

验证环境变量

设置完成后，重新打开终端并执行以下命令检查：

Terminal

env | grep ANTHROPIC

如果不再使用本服务，编辑配置文件删除相关行：

Terminal

# 编辑配置文件
nano ~/.bashrc  # 或 ~/.zshrc

# 删除包含以下内容的行：
# ANTHROPIC_BASE_URL
# ANTHROPIC_AUTH_TOKEN
# API_TIMEOUT_MS
# CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

# 重新加载配置
source ~/.bashrc  # 或 source ~/.zshrc

开始使用

Terminal

# 进入项目目录
cd ~/projects/your-project

# 启动
claude

Windows

方法1：使用 CCSwitch（小白推荐，快速导入）

步骤A：先检查并安装 Node.js / npm（环境准备）

先执行下面的命令检查是否已经安装 Node.js 和 npm。如果已经有版本号，就跳过这一步，直接进行下一步安装 codex。

PowerShell

node --version
npm --version

如果提示命令不存在，再访问 https://nodejs.org/，下载 Windows 对应的 LTS 安装包，双击 .msi 按安装向导一键安装。

安装完成后重新打开 PowerShell，再次执行上面的命令验证。出现版本号代表安装成功啦。

步骤B：安装 codex

PowerShell（管理员）

npm i -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

出现版本号就是安装成功啦。

步骤C：配置阶段使用 CCSwitch 快速导入（小白推荐）

CCS 下载地址：https://github.com/farion1231/cc-switch/releases/

一直往下面翻直到看到蓝色字体的下载地址，下载对应的系统版本。

CCSwitch 快速导入提示：

使用 CCSwitch 的可以在我站点中的 API 密钥里使用「导入 CCS」按钮快速导入。

导入后在 CCSwitch 的配置中把指定模型由原来的 gpt-5-codex 改成 gpt-5.4。

自动导入中的模型可能是旧模型，不改会影响体验。

不使用快速导入的，可以看下面的手动配置教程。

流程顺序不变：最前面依然是安装 Node/npm 和安装 codex；只是在配置阶段改为使用 CCSwitch 快速导入。

步骤D：启动 codex

PowerShell

cd C:\path\to\your\project
codex

首次启动时，codex 会进行初始化配置。

步骤E：编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

在插件市场搜索并安装 Codex - OpenAI's coding agent。

VS Code、Trae、Cursor、Kiro 这几个编辑器的操作基本一样，只要前面的 Codex 教程已经配置成功，插件打开后就能直接使用。

第一次使用时，记得在输入框右上角把 Sandbox（沙盒） 打开，再开始对话或执行任务。

方法2：手动配置

环境准备：安装 Node.js

已安装的话，先运行 node --version 和 npm --version 验证；如果已经有版本号，就跳过这一步，直接继续安装 codex。

访问 https://nodejs.org/
下载 Windows 对应的 LTS 版本安装包（需 v18 或更高）
双击 .msi 文件，按安装向导一键安装

提示：建议使用 PowerShell 而不是 CMD，以获得更好的体验。

安装完成后，打开 PowerShell，输入以下命令验证：

PowerShell

node --version
npm --version

如果显示版本号，说明安装成功了；如果这里已经有版本号，就可以直接跳到下一步安装 codex。

安装 codex

以管理员身份运行 PowerShell，执行：

PowerShell（管理员）

npm i -g @openai/codex --registry=https://registry.npmmirror.com

验证安装：

PowerShell

codex --version

出现版本号就是安装成功啦。

连接服务

打开文件资源管理器，找到 C:\Users\你的用户名\.codex 文件夹（不存在则创建）。

创建 config.toml 文件，添加以下内容：

config.toml

model_provider = "sub2api"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.sub2api]
name = "sub2api"
base_url = "https://cc.sub.258000.sbs"
wire_api = "responses"
requires_openai_auth = true

创建 auth.json 文件，添加：

auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

重要提示：● 将 sk-xxxxxxxxxxx 替换为您的 sub2 API 密钥。

修改完成 config.toml 和 auth.json 后，记得重开当前会话或者直接重开软件，再继续使用 Codex。

编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

在插件市场搜索并安装 Codex - OpenAI's coding agent。

VS Code、Trae、Cursor、Kiro 都是一样的用法，只要上面的 Codex 配置已经完成，插件打开后就能直接使用。

第一次进入插件时，记得在输入框右上角把 Sandbox（沙盒） 打开。

启动 codex

PowerShell

cd C:\path\to\your\project
codex

首次启动时，codex 会进行初始化配置。

必看：Codex 常见报错

401 错误：大概率是分组选错了，选成了 Codex 分组，没有选择每天50刀或者每天100刀分组。

403 错误：大概率是把兑换码当成密钥配置进去了，应该填写后台创建出来的 API 密钥。

429 错误：大概率是当前额度已经用完了，先去后台查看剩余额度，额度恢复后再试。

macOS

方法1：使用 CCSwitch（小白推荐，快速导入）

步骤A：先检查并安装 Node.js / npm（环境准备）

先执行下面的命令检查是否已经安装 Node.js 和 npm。如果已经有版本号，就跳过这一步，直接进行下一步安装 codex。

Terminal

node --version
npm --version

如果提示命令不存在，再访问 https://nodejs.org/，下载 macOS 对应的 LTS 安装包，打开 .pkg 按安装向导一键安装。

安装完成后重新打开终端，再次执行上面的命令验证。出现版本号代表安装成功啦。

步骤B：安装 codex

Terminal

npm i -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

出现版本号就是安装成功啦。

步骤C：配置阶段使用 CCSwitch 快速导入（小白推荐）

CCS 下载地址：https://github.com/farion1231/cc-switch/releases/

往下面翻下载对应的系统版本。

CCSwitch 快速导入提示：

使用 CCSwitch 的可以在我站点中的 API 密钥里使用「导入 CCS」按钮快速导入。

导入后在 CCSwitch 的配置中把指定模型由原来的 gpt-5-codex 改成 gpt-5.3-codex。

自动导入中的模型可能是旧模型，不改会影响体验。

不使用快速导入的，可以看下面的手动配置教程。

流程顺序不变：最前面依然是安装 Node/npm 和安装 codex；只是在配置阶段改为使用 CCSwitch 快速导入。

步骤D：启动 codex

Terminal

cd /path/to/your/project
codex

首次启动时，codex 会进行初始化配置。

步骤E：编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

在插件市场搜索并安装 Codex - OpenAI's coding agent。

VS Code、Trae、Cursor、Kiro 这几个编辑器的操作基本一样，只要前面的 Codex 教程已经配置成功，插件打开后就能直接使用。

第一次使用时，记得在输入框右上角把 Sandbox（沙盒） 打开，再开始对话或执行任务。

方法2：手动配置

环境准备：安装 Node.js

已安装的话，先运行 node --version 和 npm --version 验证；如果已经有版本号，就跳过这一步，直接继续安装 codex。

访问 https://nodejs.org/
下载适合 macOS 的 LTS 版本（需 v18 或更高）
打开下载的 .pkg 文件，按照安装向导完成

安装完成后，打开终端/命令行，输入以下命令验证：

Terminal

node --version
npm --version

如果显示版本号，说明安装成功了；如果这里已经有版本号，就可以直接跳到下一步安装 codex。

安装 codex

Terminal

npm i -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

出现版本号就是安装成功啦。

连接服务

打开文件资源管理器，找到 ~/.codex 文件夹（不存在则创建）。

创建 config.toml 文件，添加以下内容：

config.toml

model_provider = "sub2api"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.sub2api]
name = "sub2api"
base_url = "https://cc.sub.258000.sbs"
wire_api = "responses"
requires_openai_auth = true

创建 auth.json 文件，添加：

auth.json

{
  "OPENAI_API_KEY": "sk-bd1cca88e20f31daf306970196790dbd9f62f55495ba7c2d91f92115687f7303"
}

重要提示：● 将 sk-xxxxxxxxxxx 替换为您的 sub2 API 密钥。

注意：Codex 使用 OpenAI 兼容格式，端点包含 /v1 路径。

修改完成 config.toml 和 auth.json 后，记得重开当前会话或者直接重开软件，再继续使用 Codex。

编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

在插件市场搜索并安装 Codex - OpenAI's coding agent。

VS Code、Trae、Cursor、Kiro 都是一样的用法，只要上面的 Codex 配置已经完成，插件打开后就能直接使用。

第一次进入插件时，记得在输入框右上角把 Sandbox（沙盒） 打开。

必看：Codex 常见报错

401 错误：大概率是分组选错了，选成了 Codex 分组，没有选择每天50刀或者每天100刀分组。

403 错误：大概率是把兑换码当成密钥配置进去了，应该填写后台创建出来的 API 密钥。

429 错误：大概率是当前额度已经用完了，先去后台查看剩余额度，额度恢复后再试。

Linux

方法1：使用 CCSwitch（小白推荐，快速导入）

步骤A：先检查并安装 Node.js / npm（环境准备）

先执行下面的命令检查是否已经安装 Node.js 和 npm。如果已经有版本号，就跳过这一步，直接进行下一步安装 codex。

Bash

node --version
npm --version

如果提示命令不存在，再访问 https://nodejs.org/，下载 Linux 对应的 LTS 安装包或官方二进制包，按官网说明完成安装。

安装完成后重新打开终端，再次执行上面的命令验证。出现版本号代表安装成功啦。

步骤B：安装 codex

Bash

npm i -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

出现版本号就是安装成功啦。

步骤C：配置阶段使用 CCSwitch 快速导入（小白推荐）

CCS 下载地址：https://github.com/farion1231/cc-switch/releases/

往下面翻下载对应的系统版本。

CCSwitch 快速导入提示：

使用 CCSwitch 的可以在我站点中的 API 密钥里使用「导入 CCS」按钮快速导入。

导入后在 CCSwitch 的配置中把指定模型由原来的 gpt-5-codex 改成 gpt-5.3-codex。

自动导入中的模型可能是旧模型，不改会影响体验。

不使用快速导入的，可以看下面的手动配置教程。

流程顺序不变：最前面依然是安装 Node/npm 和安装 codex；只是在配置阶段改为使用 CCSwitch 快速导入。

步骤D：启动 codex

Bash

cd /path/to/your/project
codex

首次启动时，codex 会进行初始化配置。

步骤E：编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

在插件市场搜索并安装 Codex - OpenAI's coding agent。

VS Code、Trae、Cursor、Kiro 这几个编辑器的操作基本一样，只要前面的 Codex 教程已经配置成功，插件打开后就能直接使用。

第一次使用时，记得在输入框右上角把 Sandbox（沙盒） 打开，再开始对话或执行任务。

方法2：手动配置

环境准备：安装 Node.js

已安装的话，先运行 node --version 和 npm --version 验证；如果已经有版本号，就跳过这一步，直接继续安装 codex。

访问 https://nodejs.org/
下载 Linux 对应的 LTS 安装包或官方二进制包（需 v18 或更高）
按照官网提供的安装说明完成安装

安装完成后，打开终端/命令行，输入以下命令验证：

Bash

node --version
npm --version

如果显示版本号，说明安装成功了；如果这里已经有版本号，就可以直接跳到下一步安装 codex。

安装 codex

Bash

npm i -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

出现版本号就是安装成功啦。

连接服务

打开文件资源管理器，找到 ~/.codex 文件夹（不存在则创建）。

创建 config.toml 文件，添加以下内容：

config.toml

model_provider = "sub2api"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.sub2api]
name = "sub2api"
base_url = "https://cc.sub.258000.sbs"
wire_api = "responses"
requires_openai_auth = true

创建 auth.json 文件，添加：

auth.json

{
  "OPENAI_API_KEY": "sk-bd1cca88e20f31daf306970196790dbd9f62f55495ba7c2d91f92115687f7303"
}

重要提示：● 将 sk-xxxxxxxxxxx 替换为您的 sub2 API 密钥。

修改完成 config.toml 和 auth.json 后，记得重开当前会话或者直接重开软件，再继续使用 Codex。

编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

在插件市场搜索并安装 Codex - OpenAI's coding agent。

VS Code、Trae、Cursor、Kiro 都是一样的用法，只要上面的 Codex 配置已经完成，插件打开后就能直接使用。

第一次进入插件时，记得在输入框右上角把 Sandbox（沙盒） 打开。

设置环境变量

Bash

export CCH_API_KEY="your-api-key-here"

echo 'export CCH_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

启动 codex

Bash

cd /path/to/your/project
codex

常见问题

Bash

# 检查 npm 全局安装路径并添加到 PATH（如果不在）
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 检查环境变量
echo $CCH_API_KEY

# 测试网络连接
curl -I https://sub2.de5.net

# 更新 codex
npm i -g @openai/codex --registry=https://registry.npmmirror.com

openCode 对接教程：https://www.yuque.com/kongbaibuzhidaokan/xazih5/hp3g6gfqnrvtv1rg?singleDoc#

GPT-5.3 使用教程：修改配置文件（config.toml）里的模型为 gpt-5.3-codex-xhigh。

必看：Codex 常见报错

401 错误：大概率是分组选错了，选成了 Codex 分组，没有选择每天50刀或者每天100刀分组。

403 错误：大概率是把兑换码当成密钥配置进去了，应该填写后台创建出来的 API 密钥。

429 错误：大概率是当前额度已经用完了，先去后台查看剩余额度，额度恢复后再试。

Windows Terminal 是微软官方的现代化终端工具，支持多标签、字符渲染更友好、支持 emoji 和中文显示。强烈建议用它来替代自带的 cmd 和 PowerShell 窗口。

GitHub 下载

1. 安装 Node.js 环境

Gemini 需要 Node.js 环境才能运行。

💡 已安装 Node.js？运行 node --version 验证，有版本号可跳过此步骤

打开 https://nodejs.org/

点击 "LTS" 版本下载

双击 .msi 文件安装

下载 nvm-setup.exe 从 GitHub Releases

安装后运行：

GitHub 下载

加速下载：https://static.yoouu.cn/nvm-setup.exe

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

nvm install lts
nvm use lts

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

# Chocolatey
choco install nodejs
# Scoop
scoop install nodejs

验证安装

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

node --version
npm --version

显示版本号说明安装成功！

2. 安装 Gemini

全局安装

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

npm install -g @google/gemini-cli

如遇权限问题，以管理员身份运行 PowerShell

验证安装

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

gemini --version

如遇权限问题，以管理员身份运行 PowerShell

3. 设置环境变量

配置连接到中转服务。

永久设置

系统级别（需管理员权限）：

⚠️ 按 Win+X → 选择「终端管理员」或「PowerShell(管理员)」

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell (管理员)

[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://cc.sub.258000.sbs", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk_xxxxxxxxxx", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::Machine)

💡 设置后需重新打开终端

验证环境变量

设置完成后，重新打开终端并执行以下命令检查：

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell (新窗口)

Get-ChildItem Env:GEMINI_*,Env:GOOGLE_GEMINI_*

💡 将 sk_xxxxxxxxxx 请替换为官网api密钥中所申请的密钥

4. 开始使用

启动

🖥️ ⚠️ 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell

# 进入项目目录
cd C:\path\to\your\project
# 启动
gemini

💡 遇到问题？查看官方文档

1. 安装 Node.js 环境

Gemini 需要 Node.js 环境才能运行。

💡 已安装 Node.js？运行 node --version 验证，有版本号可跳过此步骤

方法一：Homebrew（推荐）

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

brew install node

方法二：nvm（多版本管理）

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc
nvm install --lts

使用国内镜像加速：

Terminal

# 设置 nvm 镜像
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
# 安装 LTS 版本
nvm install --lts

验证安装

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

node --version
npm --version

显示版本号说明安装成功！

2. 安装 Gemini

全局安装

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

npm install -g @google/gemini-cli

如遇权限问题，在命令前加 sudo

验证安装

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

gemini --version

如遇权限问题，在命令前加 sudo

3. 设置环境变量

配置连接到中转服务。

永久设置

查看当前 shell：echo $SHELL

检查是否有旧的环境变量配置：

Terminal

grep -n "GEMINI" ~/.zshrc ~/.bashrc 2>/dev/null

如果有旧配置，建议先删除再添加新配置。

Zsh (~/.zshrc)：

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

echo 'export GOOGLE_GEMINI_BASE_URL="https://cc.sub.258000.sbs"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="sk_xxxxxxxxxx"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-3-pro-preview"' >> ~/.zshrc
source ~/.zshrc

Bash (~/.bashrc)：

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

echo 'export GOOGLE_GEMINI_BASE_URL="https://cc.sub.258000.sbs"' >> ~/.bashrc
echo 'export GEMINI_API_KEY="sk_xxxxxxxxxx"' >> ~/.bashrc
echo 'export GEMINI_MODEL="gemini-3-pro-preview"' >> ~/.bashrc
source ~/.bashrc

💡 设置后需重新打开终端

验证环境变量

设置完成后，重新打开终端并执行以下命令检查：

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

echo "BASE: $GOOGLE_GEMINI_BASE_URL" && echo "KEY: $GEMINI_API_KEY" && echo "MODEL: $GEMINI_MODEL"

💡 将 sk_xxxxxxxxxx 请替换为官网api密钥中所申请的密钥

4. 开始使用

启动

🖥️ 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

# 进入项目目录
cd ~/projects/your-project
# 启动
gemini

💡 遇到问题？查看官方文档

1. 安装 Node.js 环境

Gemini 需要 Node.js 环境才能运行。

💡 已安装 Node.js？运行 node --version 验证，有版本号可跳过此步骤

方法一：nvm（推荐）

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

使用国内镜像加速：

Terminal

# 设置 nvm 镜像
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
# 安装 LTS 版本
nvm install --lts

方法二：包管理器

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

# Ubuntu/Debian
sudo apt update && sudo apt install nodejs npm
# Fedora
sudo dnf install nodejs

验证安装

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

node --version
npm --version

显示版本号说明安装成功！

2. 安装 Gemini

全局安装

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

npm install -g @google/gemini-cli

如遇权限问题，在命令前加 sudo

验证安装

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

gemini --version

如遇权限问题，在命令前加 sudo

3. 设置环境变量

配置连接到中转服务。

永久设置

查看当前 shell：echo $SHELL

检查是否有旧的环境变量配置：

Terminal

grep -n "GEMINI" ~/.zshrc ~/.bashrc 2>/dev/null

如果有旧配置，建议先删除再添加新配置。

Zsh (~/.zshrc)：

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

echo 'export GOOGLE_GEMINI_BASE_URL="https://cc.sub.258000.sbs"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="sk_xxxxxxxxxx"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-3-pro-preview"' >> ~/.zshrc
source ~/.zshrc

Bash (~/.bashrc)：

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

echo 'export GOOGLE_GEMINI_BASE_URL="https://cc.sub.258000.sbs"' >> ~/.bashrc
echo 'export GEMINI_API_KEY="sk_xxxxxxxxxx"' >> ~/.bashrc
echo 'export GEMINI_MODEL="gemini-3-pro-preview"' >> ~/.bashrc
source ~/.bashrc

💡 设置后需重新打开终端

验证环境变量

设置完成后，重新打开终端并执行以下命令检查：

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

echo "BASE: $GOOGLE_GEMINI_BASE_URL" && echo "KEY: $GEMINI_API_KEY" && echo "MODEL: $GEMINI_MODEL"

💡 将 sk_xxxxxxxxxx 请替换为官网api密钥中所申请的密钥

4. 开始使用

启动

🖥️ 在终端中执行
按 Ctrl+Alt+T 打开终端

Terminal

# 进入项目目录
cd ~/projects/your-project
# 启动
gemini

💡 遇到问题？查看官方文档

🔧 CC-Switch 配置工具

CC-Switch 是一个图形化配置管理工具，可以帮助你快速切换多个 Claude Code / Codex / Gemini 配置，无需手动修改环境变量。本人测试对于 Codex 这玩意不好用，还是老老实实用环境变量吧~

下载地址

GitHub 官方下载

https://github.com/farion1231/cc-switch

国内加速下载：

Windows (.msi) macOS (.zip)

https://static.yoouu.cn/CC-Switch-v3.8.2-Windows.msi

https://static.yoouu.cn/CC-Switch-v3.8.2-macOS.zip

Windows 配置提示

下载安装后，右键点击 CC-Switch 图标 → 属性 → 兼容性 → 勾选「以管理员身份运行此程序」

软件界面

支持管理多个配置，一键切换不同的 API 供应商：

添加配置

点击右上角 + 号添加新配置，填入供应商名称、API Key 和请求地址即可。

💡 遇到问题？查看官方文档

🔧 CC-Switch 配置工具

下载地址

GitHub 官方下载

https://github.com/farion1231/cc-switch

国内加速下载：

Windows (.msi) macOS (.zip)

https://static.yoouu.cn/CC-Switch-v3.8.2-macOS.zip

软件界面

支持管理多个配置，一键切换不同的 API 供应商。

添加配置

点击右上角 + 号添加新配置，填入供应商名称、API Key 和请求地址即可。

💡 遇到问题？查看官方文档

🔧 CC-Switch 配置工具

CC-Switch 是一个图形化配置管理工具，目前仅支持 Windows 和 macOS。Linux 用户建议直接配置环境变量。

下载地址

GitHub 官方下载

⚠️ CC-Switch 目前不支持 Linux，建议使用环境变量方式配置。

💡 遇到问题？查看官方文档

📦 opencode 配置教程

opencode 是一个开源的 AI 编程助手 CLI 工具，支持通过配置文件自定义 provider 连接中转服务。目前文档只是作为一个示例，opencode 非常不好用，你自己根据示例折腾，文档不一定正确，文档存在的意义只是告诉你可以用在 opencode。

官网 GitHub

1. 配置文件位置

全局配置: ~/.config/opencode/opencode.json

(Windows: %USERPROFILE%\.config\opencode\opencode.json)

项目配置: ./opencode.json

项目配置优先级高于全局配置

2. 选择分组类型

点击不同分组后，下方会切换对应的「安装依赖」和「配置文件」。

安装依赖（Claude）

Terminal

# 进入配置目录
cd ~/.config/opencode
# 安装 SDK
npm install @ai-sdk/anthropic

配置包含所有 Claude 子分组，修改 model 字段切换。

配置文件（Claude）

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "Forward-wuhuancun": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "sk-xxx无缓存分组密钥",
        "baseURL": "https://cc.sub.258000.sbs/v1"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "claude-haiku-4-5-20251001"
        },
        "claude-opus-4-6": {
          "name": "claude-opus-4-6"
        },
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6"
        }
      }
    },
    "Forward-hunhe": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "sk-xxx混合渠道密钥",
        "baseURL": "https://cc.sub.258000.sbs/v1"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "claude-haiku-4-5-20251001"
        },
        "claude-opus-4-6": {
          "name": "claude-opus-4-6"
        },
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6"
        }
      }
    }
  }
}

安装依赖（Gemini）

Terminal

# 进入配置目录
cd ~/.config/opencode
# 安装 SDK
npm install @ai-sdk/google

配置文件（Gemini）

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "opencode-antigravity-auth@latest"
  ],
  "provider": {
    "Forward-gemini": {
      "models": {
        " gemini-2.5-pro": {
          "name": " gemini-2.5-pro"
        },
        "gemini-3-pro-preview": {
          "name": "gemini-3-pro-preview"
        },
        "gemini-3.1-pro-preview": {
          "name": "gemini-3.1-pro-preview"
        }
      },
      "npm": "@ai-sdk/google",
      "options": {
        "apiKey": "sk-xxx",
        "baseURL": "https://cc.sub.258000.sbs/v1beta"
      }
    }
  }
}

安装依赖（Codex）

Terminal

# 进入配置目录
cd ~/.config/opencode
# 安装 SDK
npm install @ai-sdk/openai

配置文件（Codex）

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "opencode-antigravity-auth@latest"
  ],
  "provider": {
    "Forward-codex": {
      "models": {
        "GPT-5.2": {
          "name": "GPT-5.2",
          "options": {
            "reasoningEffort": "xhigh",
            "store": false,
            "include": [
              "reasoning.encrypted_content"
            ]
          }
        },
        "GPT-5.2 Codex": {
          "name": "GPT-5.2 Codex",
          "options": {
            "reasoningEffort": "xhigh",
            "store": false,
            "include": [
              "reasoning.encrypted_content"
            ]
          }
        },
        "GPT-5.3-codex": {
          "name": "GPT-5.3 Codex",
          "options": {
            "reasoningEffort": "xhigh",
            "store": false,
            "include": [
              "reasoning.encrypted_content"
            ]
          }
        }
      },
      "npm": "@ai-sdk/openai",
      "options": {
        "apiKey": "sk-xxx",
        "baseURL": "https://cc.sub.258000.sbs/v1",
        "store": false,
        "setCacheKey": true
      }
    }
  }
}

💡 复制配置后，将 sk-xxx 替换为我发货的密钥

3. 启动使用

安装 opencode 并启动：

Terminal

# 安装 opencode
npm i -g opencode-ai@latest
# 启动
opencode

💡 更多配置选项请参考 opencode 官方文档

🦞 OpenClaw 配置教程

OpenClaw（原 Clawdbot / Moltbot）是一个开源的个人 AI 助手系统，支持 Telegram、Discord、WhatsApp 等多种消息渠道，也支持通过自定义 provider 连接中转服务。下面这套内容按 cc.yoouu.cn 的页面表现方式整理到了当前项目里，直接照着抄就能用。

官方文档 GitHub 快速开始

⚠️ 先说人话：Windows 用户必须用 PowerShell 或 Windows Terminal

官方更推荐在 Windows 上使用 WSL2，但原生 Windows 也可以跑。别用 cmd，那玩意儿太古早，路径、编码、环境变量全都容易翻车。

1️⃣ 系统要求

✅ Node.js >= 22

✅ 支持 macOS / Linux / Windows

✅ Windows 官方推荐 WSL2

✅ 前置要求：先安装 Git

✅ 推荐使用 PowerShell 或 Windows Terminal

先把 Git 装好，再折腾 OpenClaw。Windows 用户建议升级到 Git 2.40+，老版本 cygpath.exe 在中文路径下容易抽风。

官方下载国内加速下载 Cloudflare 加速

⚠️ 按 Win + X → 打开「终端」或「PowerShell」，不要再拿 cmd 给自己上强度。

PowerShell

git --version
winget upgrade Git.Git

先执行下面命令验证是否已安装，有版本号就可以跳过：

PowerShell

node --version
npm --version

打开 Node.js 官网，下载 LTS 版本并安装。

如果你经常切 Node 版本，用 nvm-windows 会省很多事。

GitHub Releases 国内加速下载 Cloudflare 加速

PowerShell

nvm install lts
nvm use lts
node --version
npm --version

PowerShell

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

2️⃣ 安装 OpenClaw

OpenClaw 官方当前要求 Node 22+。最省事的方式就是全局安装 CLI。

Terminal

# 全局安装
npm install -g openclaw@latest

# 国内镜像加速安装
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 验证安装
openclaw --version

3️⃣ 运行初始化向导

先跑初始化向导，把 Gateway 和基础配置铺出来。

Terminal

openclaw onboard --install-daemon

⚠️ 向导不同版本的文案可能不完全一致，遇到没有一模一样的选项就自己翻译理解一下对应含义处理；拿不准时，优先选择 Skip、Back、No 这类跳过项，先把基础 Gateway 跑起来再说。

向导里按下面这套选就行：

选项	建议选择
Security 安全确认	`Yes`
Onboarding mode	`Manual`（手动配置）
What do you want to set up?	`Local gateway (this machine)`
Model / auth provider	`Skip for now` 或 `Back`
Gateway port	`18789`（默认）
Gateway bind	`LAN (0.0.0.0)`
Gateway auth	`Token`
Tailscale exposure	`Off`（除非你要远程访问）
Configure chat channels now?	`No`
Set GOOGLE_PLACES_API_KEY?	`No`
Configure skills now?	`No` 或 `Skip for now`

向导跑完如果提示 Model check: No auth configured，这是正常的。因为你前面跳过了官方认证，后面手动接中转服务就行。

4️⃣ 配置中转服务

编辑配置文件，添加自定义 provider。OpenClaw 默认配置目录在用户目录下：

系统	配置文件路径
macOS / Linux	`~/.openclaw/openclaw.json`
Windows	`%USERPROFILE%\\.openclaw\\openclaw.json`

可选分组

⚠️ 配置重点提示

如果在对应家的终端中可以使用，在龙虾中无法使用，那么就是配置有问题，仔细核对下面的配置信息。

先逐项对比配置：用 AI 把你当前配置和下方示例一行行对比，找出差异。
重点检查 4 个字段：baseUrl、apiKey、model.primary、models。
baseUrl 必须对应你自己的分组地址：不同分组 URL 不一样，不能乱套。
model.primary 格式必须正确：写成 provider/model-id。
models 里的模型列表要对上：模型 id、api 类型、上下文参数都别写错。
远程协助说明：龙虾目前很忙，不进行远程配置；如果付费的话我也不介意。先自己核对下面的配置信息，写得很详细，不会就问 AI。

把下面这份完整配置覆盖到配置文件里，然后把 sk-xxx 换成你自己的密钥：

把 "auth": { "mode": "token", "token": "your-token" } 这里的 token 也替换成你自己的 token。

openclaw.json（Claude）

{
  "agents": {
    "defaults": {
      "workspace": "~/clawd",
      "model": {
        "primary": "forward-cc/claude-opus-4-6"
      },
      "compaction": {
        "mode": "safeguard",
        "reserveTokensFloor": 40000
      },
      "thinkingDefault": "high",
      "timeoutSeconds": 900,
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "forward-cc": {
        "baseUrl": "https://cc.sub.258000.sbs",
        "apiKey": "sk-xxx",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "reasoning": true,
            "cost": {
              "input": 3,
              "output": 15,
              "cacheRead": 0.3,
              "cacheWrite": 3.75
            },
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6",
            "reasoning": true,
            "cost": {
              "input": 3,
              "output": 15,
              "cacheRead": 0.3,
              "cacheWrite": 3.75
            },
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "claude-haiku-4-5",
            "name": "claude-haiku-4-5",
            "reasoning": true,
            "cost": {
              "input": 3,
              "output": 15,
              "cacheRead": 0.3,
              "cacheWrite": 3.75
            },
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "auth": {
      "mode": "token",
      "token": "your-token"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  }
}

openclaw.json（Codex）

{
  "agents": {
    "defaults": {
      "workspace": "~/clawd",
      "model": {
        "primary": "forward-openai/gpt-5.4"
      },
      "compaction": {
        "mode": "safeguard",
        "reserveTokensFloor": 40000
      },
      "thinkingDefault": "high",
      "timeoutSeconds": 900,
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "forward-openai": {
        "apiKey": "sk-xxx",
        "baseUrl": "https://cc.sub.258000.sbs/v1",
        "api": "openai-responses",
        "models": [
          {
            "contextWindow": 400000,
            "cost": {
              "cacheRead": 0.175,
              "cacheWrite": 0,
              "input": 1.75,
              "output": 14
            },
            "id": "gpt-5.4",
            "maxTokens": 128000,
            "name": "gpt-5.4",
            "reasoning": true
          },
          {
            "contextWindow": 272000,
            "cost": {
              "cacheRead": 0.25,
              "cacheWrite": 0,
              "input": 2.5,
              "output": 15
            },
            "id": "gpt-5.3-codex",
            "maxTokens": 128000,
            "name": "gpt-5.3-codex",
            "reasoning": true
          }
        ]
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "auth": {
      "mode": "token",
      "token": "your-token"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  }
}

openclaw.json（Gemini）

{
  "agents": {
    "defaults": {
      "workspace": "~/clawd",
      "model": {
        "primary": "forward-gemini/gemini-3-pro-preview"
      },
      "compaction": {
        "mode": "safeguard",
        "reserveTokensFloor": 40000
      },
      "thinkingDefault": "high",
      "timeoutSeconds": 900,
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "forward-gemini": {
        "api": "google-generative-ai",
        "apiKey": "sk-xxx",
        "baseUrl": "https://cc.sub.258000.sbs/v1beta",
        "models": [
          {
            "contextWindow": 1048576,
            "cost": {
              "cacheRead": 0.2,
              "cacheWrite": 0,
              "input": 2,
              "output": 12
            },
            "id": "gemini-3-pro-preview",
            "maxTokens": 65535,
            "name": "gemini-3-pro-preview",
            "reasoning": true
          },
          {
            "contextWindow": 1048576,
            "cost": {
              "cacheRead": 0.05,
              "cacheWrite": 0,
              "input": 0.5,
              "output": 3
            },
            "id": "gemini-3-flash-preview",
            "maxTokens": 65535,
            "name": "gemini-3-flash-preview",
            "reasoning": true
          },
          {
            "contextWindow": 1048576,
            "cost": {
              "cacheRead": 0.03,
              "cacheWrite": 0,
              "input": 0.3,
              "output": 2.5
            },
            "id": "gemini-2.5-flash",
            "maxTokens": 65535,
            "name": "gemini-2.5-flash",
            "reasoning": true
          }
        ]
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "auth": {
      "mode": "token",
      "token": "your-token"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  }
}

补一句：如果你把 gateway.bind 设成 lan，建议一并加上 controlUi.allowedOrigins，不然很容易撞上 non-loopback Control UI requires gateway.controlUi.allowedOrigins 这个破错误。

5️⃣ 验证配置

别配完就发呆，先跑检查：

Terminal

# 检查配置问题
openclaw doctor

# 查看已配置的模型
openclaw models list

如果 models list 里能看到你配的模型，而且 Auth 显示 yes，说明配置成了。

6️⃣ 启动使用

Terminal

# 启动 Gateway 服务（后台运行）
openclaw gateway install
openclaw gateway start

# 或前台运行（可看日志）
openclaw gateway --verbose

# PowerShell：设置 TUI Token
$env:OPENCLAW_GATEWAY_TOKEN="your-token"
openclaw tui

# 命令行直接对话
openclaw agent --agent main --message "Hello"

# 调试技巧
openclaw doctor --fix
openclaw gateway stop
openclaw logs --follow

Gateway 管理

命令	说明
`openclaw gateway`	前台启动 Gateway
`openclaw gateway --verbose`	前台启动并显示详细日志
`openclaw gateway install`	安装 Gateway 后台服务
`openclaw gateway start`	启动后台服务
`openclaw gateway stop`	停止后台服务
`openclaw gateway restart`	重启 Gateway
`openclaw gateway status`	查看运行状态
`openclaw gateway health`	Gateway 健康检查
`openclaw gateway uninstall`	卸载 Gateway 后台服务

状态与诊断

命令	说明
`openclaw status`	快速状态总览
`openclaw status --all`	完整诊断报告
`openclaw doctor`	检查配置问题
`openclaw doctor --fix`	自动修复配置问题
`openclaw models list`	查看可用模型
`openclaw models set <model>`	切换默认模型
`openclaw configure`	重新进入交互式配置向导

渠道、插件、代理

命令	说明
`openclaw channels list`	列出已配置渠道
`openclaw channels status`	检查渠道连接状态
`openclaw channels add`	添加新渠道
`openclaw channels remove`	移除渠道
`openclaw channels login`	登录渠道账号
`openclaw plugins enable <id>`	启用指定插件
`openclaw plugins list`	列出插件
`openclaw plugins info <id>`	查看插件详情
`openclaw plugins disable <id>`	禁用插件
`openclaw plugins doctor`	插件诊断与修复
`openclaw agents list`	查看代理
`openclaw agents add [name]`	添加新代理
`openclaw sessions`	查看活跃会话
`openclaw tui`	启动 TUI 交互界面

系统管理

命令	说明
`openclaw cron list`	列出所有定时任务
`openclaw cron add`	添加定时任务
`openclaw update`	更新 OpenClaw
`openclaw dashboard`	打开 Web 管理面板
`openclaw memory search <query>`	语义搜索记忆库
`openclaw daemon install`	安装后台服务（开机自启）
`openclaw daemon uninstall`	卸载后台服务
`openclaw reset`	重置本地配置
`openclaw uninstall`	完全卸载 OpenClaw

配置改完要重启

Terminal

openclaw gateway restart

升级流程

Terminal

npm install -g openclaw@latest
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
openclaw gateway restart

多 Provider 配置

你可以在同一个配置文件里挂多个 provider，然后切默认模型。

openclaw.json

"providers": {
  "nexus": {
    "baseUrl": "https://...",
    "apiKey": "sk-xxx",
    "api": "anthropic-messages",
    "models": [...]
  },
  "nexus_codex": {
    "baseUrl": "https://...",
    "apiKey": "sk-xxx",
    "api": "openai-responses",
    "models": [...]
  }
}

openclaw models set nexus/claude-opus-4-6
openclaw models set nexus_codex/gpt-5.4
openclaw models list

Web Dashboard

Terminal

openclaw dashboard
http://localhost:18789

Dashboard 需要 Gateway 正在运行，访问时输入和 gateway.auth.token 一致的 Token。

日志文件

Terminal

# 通用
openclaw logs --follow
openclaw logs

# 直接看日志文件
tail -f ~/.openclaw/logs/gateway.log

Windows 路径：%USERPROFILE%\\.openclaw\\logs\\gateway.log

配置备份与恢复

PowerShell / Shell

# macOS / Linux 备份
cp -r ~/.openclaw ~/.openclaw.bak

# Windows PowerShell 备份
Copy-Item -Recurse $env:USERPROFILE\.openclaw $env:USERPROFILE\.openclaw.bak

# macOS / Linux 恢复
rm -rf ~/.openclaw && cp -r ~/.openclaw.bak ~/.openclaw

# Windows PowerShell 恢复
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw; Copy-Item -Recurse $env:USERPROFILE\.openclaw.bak $env:USERPROFILE\.openclaw

端口冲突处理

PowerShell / Shell

# macOS / Linux
lsof -i :18789

# Windows
netstat -ano | findstr 18789

# 修改配置后重启
openclaw gateway restart

Tailscale 远程访问

openclaw.json

"gateway": {
  "bind": "loopback",
  "tailscale": {
    "mode": "serve",
    "resetOnExit": false
  }
}

openclaw gateway restart
https://<tailscale-dns-name>

安全建议

使用强随机值作为 Gateway Token，不要拿简单密码充数。
不要把 API Key 提交到 Git 仓库，也别随便发给别人。
如果不需要局域网访问，把 gateway.bind 设为 loopback。
要远程访问优先用 Tailscale，别直接暴露端口到公网。

Terminal

openssl rand -hex 32

Web Search

网页搜索默认使用 Google Gemini Grounding，不能直接走普通中转。你得自己准备一个真实的 Google API Key。

PowerShell

[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-google-api-key", [System.EnvironmentVariableTarget]::Machine)

openclaw.json

"tools": {
  "web": {
    "search": {
      "provider": "gemini",
      "gemini": { "apiKey": "your-google-api-key" }
    }
  }
}

Memory Search

记忆系统需要 embedding 模型，支持走中转，也可以直连 Gemini。

openclaw.json

"agents": {
  "defaults": {
    "memorySearch": {
      "provider": "gemini",
      "remote": {
        "baseUrl": "https://nexusacc.itssx.com/api/gemini/gemini_api2/v1beta",
        "apiKey": "sk-xxx"
      }
    }
  }
}

Web Fetch

网页抓取是内置能力，默认不用额外 Key。目标网站太狗拦请求时，可以再单独补 Firecrawl 作为 fallback。

常见配置问题

baseUrl 末尾别带斜杠：https://xxx.itssx.com/api 才是常见正确写法。
gateway.mode 必须有：不配会报 Gateway start blocked。
model.primary 必须带 provider 前缀：nexus/claude-opus-4-6。
bind = lan 时要补 allowedOrigins：不然 Control UI 会直接罢工。

Terminal

openclaw doctor
openclaw doctor --fix
openclaw models status
openclaw logs --follow

错误信息	解决方案
`No API key found`	检查 `apiKey` 是否正确填写。
`Gateway start blocked`	在 `gateway` 中加上 `mode: "local"`。
`non-loopback Control UI requires gateway.controlUi.allowedOrigins`	补上 `controlUi.allowedOrigins`。
`Connection refused`	检查 `baseUrl` 和网络连接。
`401 Unauthorized`	检查 API Key 是否正确。
`404 Not Found`	检查 `baseUrl` 路径是否正确。

配置 Telegram

在 Telegram 搜索 @BotFather。
发送 /newbot 创建机器人。
保存返回的 Bot Token（类似 123456789:ABC...）。

Terminal

# 启用 Telegram 插件
openclaw plugins enable telegram

# 写入 Bot Token
openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"

# 启动 Gateway
openclaw gateway

# 如果前面起过服务，先停掉再拉起
openclaw gateway stop
openclaw gateway

然后在 Telegram 里给你的 bot 发消息，收到验证码后执行：

Terminal

openclaw pairing approve telegram YOUR_CODE

配对完成后，就能直接在 Telegram 里和 OpenClaw 对话了。

?? VSCode & Cursor 插件配置

?? ? 必看！不看必出问题！

必须先安装 CLI 版本并配置好环境变量，VSCode 插件才能正常使用！请先点击上方「Claude Code」标签页，完成安装教程后再来配置插件！

?? 什么是 CLI？就是上面「Claude Code」标签页里的命令行安装教程。必须先装好 CLI 版本、配好环境变量、在终端里能正常用了，VSCode 插件才能用！

?? 安装插件后如果提示 Missing environment variable: 'CRS_OAI_KEY' 或找不到 API Key，请重启电脑后再试！

1?? 安装 Claude Code 插件

在 VSCode 扩展商店搜索 Claude 并安装官方插件。

官方插件地址

?? 认准官方插件，别下载错了！

2?? 配置插件

配置文件位置

%USERPROFILE%\.claude\config.json

一键写入命令

??? ?? 必须用 PowerShell 或 Windows Terminal！cmd 是上古遗物，用它必出问题！
按 Win+X → 选择「终端」或「PowerShell」

PowerShell（直接运行）

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude" | Out-Null; Set-Content -Path "$env:USERPROFILE\.claude\config.json" -Value '{"primaryApiKey": "crs"}'

或手动创建文件，写入以下内容：

config.json

{"primaryApiKey": "crs"}

?? 这里就是填 "crs"，不是填我发货的密钥！

?? 配置完成后需要重启 VSCode 才能生效，不生效就重启电脑（确保 CLI 版本能正常使用）

3?? 使用效果

配置成功后，在 VSCode 中可以直接使用 Claude Code 插件进行 AI 辅助编程。

?? 遇到问题？查看官方文档

1?? 安装 Codex 插件

在插件市场搜索并安装 Codex - OpenAI's coding agent。

2?? 使用前确认

VS Code、Trae、Cursor、Kiro 都是一样的用法，只要上方 Codex 模块里的配置已经完成，Codex 插件打开后就能直接使用。

第一次进入插件时，记得在输入框右上角把 Sandbox（沙盒） 打开。

3?? 使用效果

配置成功后，就可以直接在编辑器里使用 Codex 插件进行 AI 辅助编程。

?? VSCode & Cursor 插件配置

?? ? 必看！不看必出问题！

必须先安装 CLI 版本并配置好环境变量，VSCode 插件才能正常使用！请先点击上方「Claude Code」标签页，完成安装教程后再来配置插件！

?? 什么是 CLI？就是上面「Claude Code」标签页里的命令行安装教程。必须先装好 CLI 版本、配好环境变量、在终端里能正常用了，VSCode 插件才能用！

?? 安装插件后如果提示 Missing environment variable: 'CRS_OAI_KEY' 或找不到 API Key，请重启电脑后再试！

1?? 安装 Claude Code 插件

在 VSCode 扩展商店搜索 Claude 并安装官方插件。

官方插件地址

?? 认准官方插件，别下载错了！

2?? 配置插件

配置文件位置

~/.claude/config.json

一键写入命令

??? 在终端 (Terminal.app) 中执行
按 Cmd+空格 → 输入 Terminal → 回车

Terminal

mkdir -p ~/.claude && echo '{"primaryApiKey": "crs"}' > ~/.claude/config.json

或手动创建文件，写入以下内容：

config.json

{"primaryApiKey": "crs"}

?? 这里就是填 "crs"，不是填我发货的密钥！

?? 配置完成后需要重启 VSCode 才能生效，不生效就重启电脑（确保 CLI 版本能正常使用）

3?? 使用效果

配置成功后，在 VSCode 中可以直接使用 Claude Code 插件进行 AI 辅助编程。

?? 遇到问题？查看官方文档

1?? 安装 Codex 插件

在插件市场搜索并安装 Codex - OpenAI's coding agent。

2?? 使用前确认

VS Code、Trae、Cursor、Kiro 都是一样的用法，只要上方 Codex 模块里的配置已经完成，Codex 插件打开后就能直接使用。

第一次进入插件时，记得在输入框右上角把 Sandbox（沙盒） 打开。

3?? 使用效果

配置成功后，就可以直接在编辑器里使用 Codex 插件进行 AI 辅助编程。

?? VSCode & Cursor 插件配置

?? ? 必看！不看必出问题！

必须先安装 CLI 版本并配置好环境变量，VSCode 插件才能正常使用！请先点击上方「Claude Code」标签页，完成安装教程后再来配置插件！

?? 什么是 CLI？就是上面「Claude Code」标签页里的命令行安装教程。必须先装好 CLI 版本、配好环境变量、在终端里能正常用了，VSCode 插件才能用！

?? 安装插件后如果提示 Missing environment variable: 'CRS_OAI_KEY' 或找不到 API Key，请重启电脑后再试！

1?? 安装 Claude Code 插件

在 VSCode 扩展商店搜索 Claude 并安装官方插件。

官方插件地址

?? 认准官方插件，别下载错了！

2?? 配置插件

配置文件位置

~/.claude/config.json

一键写入命令

Terminal

mkdir -p ~/.claude && echo '{"primaryApiKey": "crs"}' > ~/.claude/config.json

或手动创建文件，写入以下内容：

config.json

{"primaryApiKey": "crs"}

?? 这里就是填 "crs"，不是填我发货的密钥！

?? 配置完成后需要重启 VSCode 才能生效，不生效就重启电脑（确保 CLI 版本能正常使用）

3?? 使用效果

配置成功后，在 VSCode 中可以直接使用 Claude Code 插件进行 AI 辅助编程。

?? 遇到问题？查看官方文档

1?? 安装 Codex 插件

在插件市场搜索并安装 Codex - OpenAI's coding agent。

2?? 使用前确认

VS Code、Trae、Cursor、Kiro 都是一样的用法，只要上方 Codex 模块里的配置已经完成，Codex 插件打开后就能直接使用。

第一次进入插件时，记得在输入框右上角把 Sandbox（沙盒） 打开。

3?? 使用效果

配置成功后，就可以直接在编辑器里使用 Codex 插件进行 AI 辅助编程。

📊 Claude Code 状态栏插件教程

状态栏插件可以在终端显示模型信息、Git 分支、Token 使用量、会话成本等实时指标。以下是几款流行的状态栏插件，选择适合你的使用。

选择插件

GitHub

https://github.com/Haleclipse/CCometixLine

CCometixLine 是用 Rust 编写的高性能 Claude Code 状态栏工具，相比 Node.js 实现更轻量、启动更快。支持实时使用追踪、Git 集成、交互式 TUI 配置界面。

✅ Rust 编写，性能更高、内存占用更低
✅ 实时 Token 使用追踪和成本计算
✅ Git 分支和状态集成
✅ 交互式 TUI 配置界面

1️⃣ 安装

使用 npm 全局安装：

Terminal

npm install -g @cometix/ccline

或使用镜像源：

Terminal

npm install -g @cometix/ccline --registry https://registry.npmmirror.com

2️⃣ 配置

运行以下命令启动交互式配置：

Terminal

ccline --config

配置文件位置：~/.claude/ccline/config.toml

3️⃣ 添加到 Claude Code

在 Claude Code 的 settings.json 中添加以下配置：

Linux/macOS:

settings.json

{ "statusLine": { "type": "command", "command": "~/.claude/ccline/ccline", "padding": 0 } }

Windows:

settings.json

{ "statusLine": { "type": "command", "command": "%USERPROFILE%\\.claude\\ccline\\ccline.exe", "padding": 0 } }

💡 遇到问题？查看官方文档

⚠️ 此插件已较长时间未更新，可能存在兼容性问题。建议优先考虑 CCometixLine。

GitHub

https://github.com/sirmalloc/ccstatusline

ccstatusline 是一个高度可定制的 Claude Code 状态栏工具，可以在终端显示模型信息、Git 分支、Token 使用量、会话成本等实时指标，支持 Powerline 风格和多行显示。

1️⃣ 启动配置工具

运行以下命令启动交互式配置界面：

Terminal

npx ccstatusline@latest

2️⃣ 主菜单说明

配置工具主菜单包含以下选项：

Edit Lines - 编辑状态行和组件
Edit Colors - 自定义颜色
Powerline Setup - Powerline 字体和样式
Terminal Options - 终端宽度设置
Global Overrides - 全局样式覆盖
Install to Claude Code - 安装到 Claude Code

3️⃣ 添加组件教程

按照以下步骤添加状态栏组件：

选择 Edit Lines 进入编辑
选择要编辑的行（Line 1/2/3）
按 (a) 添加新组件
用 ↑↓ 选择组件类型
按 Enter 确认添加
按 Ctrl+S 保存配置

4️⃣ 安装到 Claude Code

配置完成后，将状态栏安装到 Claude Code：

选择 Install to Claude Code
确认安装
重启 Claude Code 生效

💡 配置保存在 ~/.config/ccstatusline/settings.json，重启 Claude Code 后生效。

💡 遇到问题？查看官方文档

GitHub

https://github.com/Owloops/claude-powerline

Vim-style Powerline 风格的状态栏插件，支持实时 Token 追踪、Git 集成和自定义主题。

✅ 经典 Powerline 箭头风格
✅ 实时 Token 追踪
✅ Git 集成
✅ 自定义主题支持

安装

Terminal

npm install -g claude-powerline

💡 遇到问题？查看官方文档

GitHub

https://github.com/chongdashu/cc-statusline

简单易上手的状态栏插件，提供交互式设置向导，支持目录、Git 分支、模型等基本信息显示。

✅ 简单易上手
✅ 交互式设置向导
✅ 显示当前目录、Git 分支、模型信息

安装

Terminal

npx cc-statusline

💡 遇到问题？查看官方文档

GitHub

https://github.com/levz0r/claude-code-statusline

功能全面的状态栏插件，支持实时 Token 追踪、成本计算、Git 集成等。

✅ 实时 Token 追踪
✅ 成本计算
✅ Git 集成
✅ 功能比较全面

安装

Terminal

npx claude-code-statusline

💡 遇到问题？查看官方文档

🔧 MCP 服务器配置教程

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议，让 Claude Code 能够连接外部工具和数据源，大幅扩展 AI 的能力边界。

官方文档官方服务器

1️⃣ 什么是 MCP？

MCP 让 Claude Code 能够：

✅ 访问最新的库和框架文档（如 Context7）
✅ 操作 GitHub、Notion、Figma 等外部服务
✅ 执行浏览器自动化、数据库查询等任务
✅ 连接 Zapier 等自动化平台实现跨应用工作流

2️⃣ 配置文件位置

MCP 配置存储在 JSON 文件中，支持全局和项目级别配置：

作用域	路径
全局 (macOS/Linux)	`~/.claude/mcp.json`
全局 (Windows)	`%USERPROFILE%\.claude\mcp.json`
项目级别	`.claude/mcp.json`

3️⃣ 安装方式

使用 Claude Code 内置命令管理 MCP 服务器：

Terminal

# 本地运行（npx）
claude mcp add  -- npx -y 
# 远程连接（HTTP）
claude mcp add --transport http  
# 查看已安装
claude mcp list
# 移除服务器
claude mcp remove

直接编辑 mcp.json 配置文件添加服务器。

4️⃣ 热门 MCP 服务器

以下是社区推荐的常用 MCP 服务器：

💡 命令分两种：claude mcp add 是 Claude Code 内置命令，会自动注册到配置；npx @composio/mcp setup 是 Composio 的安装向导，也会自动配置。

Context7

获取最新的库和框架文档、API 信息、代码示例（需要 API Key）

Terminal

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

GitHub

访问 GitHub 仓库、Issue、PR，支持代码搜索和文件操作（需要 API Key）

Terminal

npx @composio/mcp@latest setup github --client claude

Playwright

浏览器自动化和网页抓取，支持截图、表单填写、数据提取

Terminal

claude mcp add --scope user playwright -- npx -y @executeautomation/mcp-playwright

Puppeteer

无头浏览器控制、网页抓取、PDF 生成、表单自动化

Terminal

claude mcp add --scope user puppeteer -- npx -y @modelcontextprotocol/server-puppeteer

Docker

容器生命周期管理、镜像构建、Docker Compose 编排

Terminal

claude mcp add --scope user docker -- npx -y @modelcontextprotocol/server-docker

Sequential Thinking

链式思维推理、逐步问题解决、复杂任务分析

Terminal

claude mcp add --scope user thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Notion

访问和管理 Notion 工作区、搜索页面、创建笔记、更新数据库（需要 API Key）

Terminal

npx @composio/mcp@latest setup notion --client claude

PostgreSQL

SQL 查询执行、模式检查、连接池、只读模式

Terminal

claude mcp add --scope user postgres -- npx -y @modelcontextprotocol/server-postgres

Filesystem

本地文件读写、目录操作

Terminal

claude mcp add --scope user filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

5️⃣ Context7 详细教程

Context7 是最受欢迎的 MCP 服务器之一，可以让 Claude Code 访问最新的库和框架文档，避免使用过时的 API。

官网获取 API Key GitHub

安装方式

方式一：远程连接（推荐，全局可用）

Terminal

claude mcp add --transport http --scope user context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"

方式二：本地运行

Terminal

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

使用方法

在提示词中加入 use context7 即可让 Claude Code 查询最新文档：

示例

# 示例
用 Vue 3 创建一个响应式表单组件 use context7

⚠️ 注意事项

每个项目启用的 MCP 不要超过 10 个，活跃工具不超过 80 个
200k 上下文窗口可能因工具过多缩减至 70k
需要 API Key 的服务器请替换 YOUR_API_KEY 为实际密钥
部分 MCP 服务器需要额外安装依赖，请参考各自的官方文档

💡 遇到问题？查看官方文档

🔧 MCP 服务器配置教程

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议，让 Claude Code 能够连接外部工具和数据源，大幅扩展 AI 的能力边界。

官方文档官方服务器

1️⃣ 什么是 MCP？

MCP 让 Claude Code 能够：

✅ 访问最新的库和框架文档（如 Context7）
✅ 操作 GitHub、Notion、Figma 等外部服务
✅ 执行浏览器自动化、数据库查询等任务
✅ 连接 Zapier 等自动化平台实现跨应用工作流

2️⃣ 配置文件位置

MCP 配置存储在 JSON 文件中，支持全局和项目级别配置：

作用域	路径
全局 (macOS/Linux)	`~/.claude/mcp.json`
项目级别	`.claude/mcp.json`

3️⃣ 安装方式

使用 Claude Code 内置命令管理 MCP 服务器：

Terminal

# 本地运行（npx）
claude mcp add  -- npx -y 
# 远程连接（HTTP）
claude mcp add --transport http  
# 查看已安装
claude mcp list
# 移除服务器
claude mcp remove

直接编辑 ~/.claude/mcp.json 配置文件添加服务器。

4️⃣ 热门 MCP 服务器

以下是社区推荐的常用 MCP 服务器：

💡 命令分两种：claude mcp add 是 Claude Code 内置命令，会自动注册到配置；npx @composio/mcp setup 是 Composio 的安装向导，也会自动配置。

Context7

获取最新的库和框架文档、API 信息、代码示例（需要 API Key）

Terminal

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

GitHub

访问 GitHub 仓库、Issue、PR，支持代码搜索和文件操作（需要 API Key）

Terminal

npx @composio/mcp@latest setup github --client claude

Playwright

浏览器自动化和网页抓取，支持截图、表单填写、数据提取

Terminal

claude mcp add --scope user playwright -- npx -y @executeautomation/mcp-playwright

Puppeteer

无头浏览器控制、网页抓取、PDF 生成、表单自动化

Terminal

claude mcp add --scope user puppeteer -- npx -y @modelcontextprotocol/server-puppeteer

Docker

容器生命周期管理、镜像构建、Docker Compose 编排

Terminal

claude mcp add --scope user docker -- npx -y @modelcontextprotocol/server-docker

Sequential Thinking

链式思维推理、逐步问题解决、复杂任务分析

Terminal

claude mcp add --scope user thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Notion

访问和管理 Notion 工作区、搜索页面、创建笔记、更新数据库（需要 API Key）

Terminal

npx @composio/mcp@latest setup notion --client claude

PostgreSQL

SQL 查询执行、模式检查、连接池、只读模式

Terminal

claude mcp add --scope user postgres -- npx -y @modelcontextprotocol/server-postgres

Filesystem

本地文件读写、目录操作

Terminal

claude mcp add --scope user filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

5️⃣ Context7 详细教程

Context7 是最受欢迎的 MCP 服务器之一，可以让 Claude Code 访问最新的库和框架文档，避免使用过时的 API。

官网获取 API Key GitHub

安装方式

方式一：远程连接（推荐，全局可用）

Terminal

claude mcp add --transport http --scope user context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"

方式二：本地运行

Terminal

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

使用方法

在提示词中加入 use context7 即可让 Claude Code 查询最新文档：

示例

# 示例
用 Vue 3 创建一个响应式表单组件 use context7

⚠️ 注意事项

每个项目启用的 MCP 不要超过 10 个，活跃工具不超过 80 个
200k 上下文窗口可能因工具过多缩减至 70k
需要 API Key 的服务器请替换 YOUR_API_KEY 为实际密钥
部分 MCP 服务器需要额外安装依赖，请参考各自的官方文档

💡 遇到问题？查看官方文档

🔧 MCP 服务器配置教程

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议，让 Claude Code 能够连接外部工具和数据源，大幅扩展 AI 的能力边界。

官方文档官方服务器

1️⃣ 什么是 MCP？

MCP 让 Claude Code 能够：

✅ 访问最新的库和框架文档（如 Context7）
✅ 操作 GitHub、Notion、Figma 等外部服务
✅ 执行浏览器自动化、数据库查询等任务
✅ 连接 Zapier 等自动化平台实现跨应用工作流

2️⃣ 配置文件位置

MCP 配置存储在 JSON 文件中，支持全局和项目级别配置：

作用域	路径
全局 (Linux/WSL)	`~/.claude/mcp.json`
项目级别	`.claude/mcp.json`

3️⃣ 安装方式

使用 Claude Code 内置命令管理 MCP 服务器：

Terminal

# 本地运行（npx）
claude mcp add  -- npx -y 
# 远程连接（HTTP）
claude mcp add --transport http  
# 查看已安装
claude mcp list
# 移除服务器
claude mcp remove

直接编辑 ~/.claude/mcp.json 配置文件添加服务器。

4️⃣ 热门 MCP 服务器

以下是社区推荐的常用 MCP 服务器：

💡 命令分两种：claude mcp add 是 Claude Code 内置命令，会自动注册到配置；npx @composio/mcp setup 是 Composio 的安装向导，也会自动配置。

Context7

获取最新的库和框架文档、API 信息、代码示例（需要 API Key）

Terminal

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

GitHub

访问 GitHub 仓库、Issue、PR，支持代码搜索和文件操作（需要 API Key）

Terminal

npx @composio/mcp@latest setup github --client claude

Playwright

浏览器自动化和网页抓取，支持截图、表单填写、数据提取

Terminal

claude mcp add --scope user playwright -- npx -y @executeautomation/mcp-playwright

Puppeteer

无头浏览器控制、网页抓取、PDF 生成、表单自动化

Terminal

claude mcp add --scope user puppeteer -- npx -y @modelcontextprotocol/server-puppeteer

Docker

容器生命周期管理、镜像构建、Docker Compose 编排

Terminal

claude mcp add --scope user docker -- npx -y @modelcontextprotocol/server-docker

Sequential Thinking

链式思维推理、逐步问题解决、复杂任务分析

Terminal

claude mcp add --scope user thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Notion

访问和管理 Notion 工作区、搜索页面、创建笔记、更新数据库（需要 API Key）

Terminal

npx @composio/mcp@latest setup notion --client claude

PostgreSQL

SQL 查询执行、模式检查、连接池、只读模式

Terminal

claude mcp add --scope user postgres -- npx -y @modelcontextprotocol/server-postgres

Filesystem

本地文件读写、目录操作

Terminal

claude mcp add --scope user filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

5️⃣ Context7 详细教程

Context7 是最受欢迎的 MCP 服务器之一，可以让 Claude Code 访问最新的库和框架文档，避免使用过时的 API。

官网获取 API Key GitHub

安装方式

方式一：远程连接（推荐，全局可用）

Terminal

claude mcp add --transport http --scope user context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"

方式二：本地运行

Terminal

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

使用方法

在提示词中加入 use context7 即可让 Claude Code 查询最新文档：

示例

# 示例
用 Vue 3 创建一个响应式表单组件 use context7

⚠️ 注意事项

每个项目启用的 MCP 不要超过 10 个，活跃工具不超过 80 个
200k 上下文窗口可能因工具过多缩减至 70k
需要 API Key 的服务器请替换 YOUR_API_KEY 为实际密钥
部分 MCP 服务器需要额外安装依赖，请参考各自的官方文档

💡 遇到问题？查看官方文档

🔥 Claude + Codex + Gemini + OpenClaw

🛒 购买渠道 & 售后服务

一号店铺

二号店铺

售后服务

为什么选我？

🚨 重要说明

🤔 常遇问题

Codex 日卡周卡月卡看这里

兑换码使用教程（重要）

5. 安装与使用教程

💡 推荐使用 WSL 或 Git Bash

💡 推荐使用 Windows Terminal

0 ⚠️ 前置要求：安装 Git

验证安装

⭐ 原生安装（推荐）

第一步：安装 Node.js 18+

第二步：使用 npm 全局安装 Claude Code

验证安装

设置环境变量

永久设置

验证环境变量

开始使用

⭐ 原生安装（推荐）

1. 安装 Node.js (v18+)

使用 Homebrew

验证 Node.js 安装

2. 安装 Claude Code

3. 验证 Claude Code 安装

验证安装

设置环境变量

检查配置文件：

检查环境变量：

清理旧配置

永久设置

验证环境变量

开始使用

⭐ 原生安装（推荐）

1. 安装 Node.js (v18+)

Ubuntu/Debian

Fedora/RHEL

2. 安装 Claude Code

验证安装

设置环境变量

永久设置

验证环境变量

开始使用

Windows

方法1：使用 CCSwitch（小白推荐，快速导入）

方法2：手动配置

环境准备：安装 Node.js

安装 codex

连接服务

编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

启动 codex

必看：Codex 常见报错

macOS

方法1：使用 CCSwitch（小白推荐，快速导入）

方法2：手动配置

环境准备：安装 Node.js

安装 codex

连接服务

编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

必看：Codex 常见报错

Linux

方法1：使用 CCSwitch（小白推荐，快速导入）

方法2：手动配置

环境准备：安装 Node.js

安装 codex

连接服务

编辑器插件使用（VS Code / Cursor / Trae / Kiro 通用）

设置环境变量

启动 codex

常见问题

必看：Codex 常见报错

1. 安装 Node.js 环境

验证安装

2. 安装 Gemini

全局安装

验证安装