Claude Code 国内使用攻略

Claude Code 是 Anthropic 推出的强大终端 AI 编程助手，能够理解整个项目、直接修改代码并执行复杂开发任务。但对于国内开发者来说，官方服务存在访问限制和成本问题。本文将带你一步步完成 Claude Code 的完整配置，实现无需魔法、稳定使用、低成本的 AI 编程体验。

1. 使用 Node.js 安装 Claude Code

1.1 前置条件：安装 Node.js 18+

Claude Code 依赖 Node.js 18.0 或更高版本运行。

Windows 系统：

• 推荐：访问 Node.js 官网 下载 LTS 长期支持版（.msi 格式）
• 或使用包管理器：

  # 使用 Winget
  winget install OpenJS.NodeJS.LTS
  
  # 使用 Chocolatey
  choco install nodejs
  

macOS 系统：

# 使用 Homebrew
brew install node

Linux (Ubuntu/Debian) 系统：

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

验证安装：

node --version
npm --version

显示版本号即表示安装成功。

1.2 安装 Claude Code

国内用户推荐使用镜像加速：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

国际网络用户：

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

验证安装：

claude --version

如果能看到版本号输出，说明 Claude Code 已成功安装。

2. 安装 cc-switch 配置管理工具

cc-switch 是一款跨平台的开源桌面工具，专为 Claude Code 等 AI 命令行助手设计。它本质上是一个协议转换层 + 智能路由器，可以一键切换不同大模型服务商的 API 配置，完美解决国内访问问题。

2.1 推荐安装方式：桌面应用（图形界面）

1. 访问 cc-switch GitHub Releases 页面
2. 根据你的系统下载对应安装包：
   • Windows：下载 .exe 文件
   • macOS：下载 .dmg 文件（注意区分 Intel 和 Apple Silicon 版本）
   • Linux：下载 .AppImage 或 .flatpak 文件
3. 双击安装包，按照向导完成安装
4. 安装完成后启动 cc-switch，它会在系统托盘运行

2.2 备选安装方式：npm 命令行版

如果你更喜欢命令行操作：

npm install -g cc-switch

验证安装：

cc-switch --version

3. 在 cc-switch 部署国内大模型（以 Minimax 为例）

目前国内主流大模型中，MiniMax M2.7 在代码能力、响应速度和价格方面表现均衡，是 Claude Code 的理想替代方案。

3.1 获取 MiniMax API Key

1. 访问 MiniMax 开发者平台 并注册登录
2. 进入「Coding Plan」订阅页面，完成套餐订阅（新用户有免费体验金）
3. 在 Coding Plan 控制台页面，找到「API Key」区域
4. 点击「复制并重置」按钮，获取完整的 API Key（以 sk- 开头）

   ⚠️ 重要：请妥善保存你的 API Key，不要泄露给他人

3.2 在 cc-switch 中添加 MiniMax 配置

1. 打开 cc-switch 桌面应用
2. 点击主界面右上角的橙色「+」按钮，进入「添加新供应商」页面
3. 在预设供应商列表中选择 MiniMax
4. 在 API Key 输入框中粘贴你刚才复制的 MiniMax API Key
5. 模型名称保持默认的 MiniMax-M2.7 即可
6. 点击右下角的「添加」按钮保存配置

3.3 启用 MiniMax 配置

1. 回到 cc-switch 主界面
2. 在供应商列表中找到你刚刚添加的 MiniMax 条目
3. 点击「启用」按钮
4. cc-switch 会自动配置 Claude Code 的环境变量和代理设置

3.4 验证配置是否生效

打开一个新的终端窗口，运行：

claude "你好，告诉我你现在使用的是什么模型"

如果 Claude 回复说它正在使用 MiniMax 模型，说明配置成功了！

类似GLM、DeepSeek等模型都可以在cc-switch中配置

4. 国内环境实现 Web Search 功能

Claude Code 内置的 fetch 和 web_search 工具在国内环境下经常受限。我们可以通过 MCP（Model Context Protocol）服务器来实现更强大、更稳定的网络访问能力。

4.1 推荐的 MCP 工具对比

工具	功能	优势	适用场景
Fetch MCP	获取网页内容、API 响应	简单易用、自动转 Markdown、支持代理	普通网页抓取、API 调用
Playwright MCP	自动化浏览器交互	支持 JS 渲染、截图、登录后内容	动态网页、复杂交互
Chrome DevTools MCP	控制 Chrome 浏览器	基于 Puppeteer、调试功能强	网页调试、自动化测试

4.2 安装 Fetch MCP（推荐首选）

Fetch MCP 是最适合替代内置 fetch 工具的方案，它不受 Anthropic 政策限制，支持国内网站访问。

通过 Claude Code CLI 安装：

claude mcp add --scope user fetch -- uvx mcp-server-fetch

通过 pip 安装：

pip install mcp-server-fetch
claude mcp add --scope user fetch -- python -m mcp_server_fetch

4.3 Fetch MCP 核心特性

• ✅ 不受政策限制：可访问国内绝大多数网站
• ✅ 自动格式转换：将 HTML 自动转换为 Markdown，便于 AI 理解
• ✅ 支持代理：可通过 --proxy-url 参数配置国内代理
• ✅ 忽略 robots.txt：可通过 --ignore-robots-txt 参数绕过限制
• ✅ 内置缓存：15 分钟缓存，重复访问更快
• ✅ 自定义 User-Agent：避免被网站屏蔽

4.4 使用示例

直接调用工具：

/fetch:fetch https://juejin.cn/user/4151367379457848

通过自然语言调用：

请使用 fetch 工具获取 https://github.com/farion1231/cc-switch 的 README 内容

4.5 进阶：Playwright MCP 处理动态网页

对于需要 JavaScript 渲染的动态网页（如 SPA 应用、需要登录的网站），推荐使用 Playwright MCP：

安装：

claude mcp add --scope user playwright npx @playwright/mcp@latest

使用示例：

使用 playwright 导航到百度，搜索"Claude Code 国内使用教程"，然后获取搜索结果页面的内容