🔥 Claude + Gemini

支持 Claude Code、Gemini CLI 国内直连，官方原版体验

🛒 购买渠道 & 售后服务

一号店铺

一号店铺

二号店铺

二号店铺

售后服务

售后服务

技术支持进群找群主，不定时抽奖额度

为什么选我？

✅ 双平台 - 一站搞定两大 AI 编程神器
✅ 稳定 - 告别 500/422/402，专线直连
✅ 低价 - 同等服务价格最优
✅ 无限制 - 不限 key、设备
✅ 售后好 - 服务原因不可用按量退

🚨 重要说明

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

🤔 常遇问题

切换分组后出现 400 报错？

如果在同一个会话中切换了不同的分组（例如从 Claude中的无缓存分组 切换到 有缓存分组时），可能会遇到 400 错误。

解决方案：请重启会话恢复正常。

5. 安装与使用教程

💡 推荐使用 WSL 或 Git Bash

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

💡 推荐使用 Windows Terminal

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

GitHub 下载
Windows Terminal Preview

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：

  1. 访问 nvm-windows Releases
  2. 下载最新版的 nvm-setup.exe 并安装
  3. 安装完成后，打开新的 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 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 配置工具

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-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. 安装依赖

在配置目录安装对应的 SDK 包（根据分组选择）

Terminal 
# 进入配置目录
cd ~/.config/opencode
# 安装 SDK (根据分组选择)
# Claude: npm install @ai-sdk/anthropic
# Gemini: npm install @ai-sdk/google
# Codex:  npm install @ai-sdk/openai

3. 配置示例

选择分组类型:

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

在配置文件中添加以下内容：

opencode.json 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "名称用英文代替": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "your-claude_code-key",
        "baseURL": "https://cc.sub.258000.sbs"
      },
      "models": {
        "claude-sonnet-4-5-20250929": { "name": "Claude Sonnet 4.5", "attachment": true }
      }
    },
    "nexus-max200cc": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "your-claude_code-key",
        "baseURL": "https://crs2.itssx.com/api/claude_code/max200cc/v1"
      },
      "models": {
        "claude-sonnet-4-5-20250929": { "name": "Claude Sonnet 4.5", "attachment": true }
      }
    },
    "nexus-cc-glm": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "your-claude_code-key",
        "baseURL": "https://crs2.itssx.com/api/claude_code/cc_glm/v1"
      },
      "models": {
        "claude-sonnet-4-5-20250929": { "name": "Claude Sonnet 4.5", "attachment": true }
      }
    },
    "nexus-cc-minimax21": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "your-claude_code-key",
        "baseURL": "https://crs2.itssx.com/api/claude_code/cc_minimax21/v1"
      },
      "models": {
        "claude-sonnet-4-5-20250929": { "name": "Claude Sonnet 4.5", "attachment": true }
      }
    }
  },
  "model": "nexus-mixedcc/claude-sonnet-4-5-20250929"
}

在配置文件中添加以下内容：

opencode.json 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-gemini": {
      "npm": "@ai-sdk/google",
      "options": {
        "apiKey": "your-gemini-key",
        "baseURL": "https://crs2.itssx.com/api"
      },
      "models": {
        "gemini-3-pro-preview": {
          "name": "Gemini 3 Pro",
          "attachment": true
        }
      }
    }
  },
  "model": "ai-gemini/gemini-3-pro-preview"
}

在配置文件中添加以下内容：

opencode.json 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-codex": {
      "npm": "@ai-sdk/openai",
      "options": {
        "apiKey": "your-codex-key",
        "baseURL": "https://crs2.itssx.com/api"
      },
      "models": {
        "gpt-5.2-codex-max": {
          "name": "GPT 5.2 Codex Max",
          "attachment": true
        }
      }
    }
  },
  "model": "ai-codex/gpt-5.2-codex-max"
}
💡 将 your-xxx-key 替换为我发货的密钥

4. 启动使用

安装 opencode 并启动：

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

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

🔌 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 辅助编程。

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

🔌 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 辅助编程。

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

🔌 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 辅助编程。

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

📊 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️⃣ 添加组件教程

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

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

4️⃣ 安装到 Claude Code

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

  1. 选择 Install to Claude Code
  2. 确认安装
  3. 重启 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 服务器需要额外安装依赖，请参考各自的官方文档

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