Claude Code国内怎么安装配置？免魔法/不翻墙完整指南（2026版）

直接答案

在国内用 Claude Code，配一个 API endpoint 就行——不需要 VPN、不需要 cc-switch、不需要装任何额外的代理工具。安装 Claude Code 本体（npm 一行命令），然后在配置文件中指定 TeamoRouter 的 API 地址和 Key，启动就能直接用 Claude 原生模型（Opus 4.8 / Sonnet 5 / Fable 5）。全程 10 分钟。

核心原理：Claude Code 的 API 模式原生兼容 OpenAI 的 endpoint 格式。TeamoRouter 提供的就是标准 OpenAI 兼容接口，所以只需要改 ANTHROPIC_BASE_URL 这一个环境变量，Claude Code 就会把所有请求发到 TeamoRouter，由后者路由到 Anthropic 官方 API——你完全不用操心网络、支付和模型切换的问题。

下面按操作系统分步拆解。

第一步：安装 Claude Code

前置条件

• Node.js 18+（必须）：Claude Code 基于 Node.js 运行。从 nodejs.org 下载 LTS 版本安装即可，国内下载速度正常，无需代理。
• Git（Windows 用户必须）：Claude Code 底层依赖 Git。Windows 用户可通过 winget install Git.Git 安装。

验证环境：

node -v   # 应显示 v18.x 或更高
npm -v    # 应显示 9.x 或更高
git --version  # Windows 用户确认

macOS

推荐使用 Homebrew：

brew install --cask claude-code@latest

或者通过 npm（国内用户建议使用淘宝镜像加速）：

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

安装完成后验证：

claude --version

Windows

推荐使用 winget：

winget install Anthropic.ClaudeCode

备选 npm 方式（PowerShell 管理员身份运行）：

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

常见问题：安装后如果提示 claude 不是内部命令，需要将 npm 全局 bin 目录（通常是 C:\Users\你的用户名\.local\bin 或 %APPDATA%\npm）添加到系统环境变量 PATH 中，重启终端即可。

PowerShell 执行策略问题：如果遇到脚本执行被禁的报错，以管理员身份运行：

powershell复制

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Linux（Ubuntu/Debian）

先通过 nvm 安装 Node.js 20（推荐，避免系统自带的低版本 Node）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

然后安装 Claude Code：

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

第二步：配置 API Endpoint（核心步骤）

这是国内免魔法使用的关键——不需要装 cc-switch，不需要装任何路由插件，只改一个配置文件。

找到或创建配置文件

配置文件位置：

• macOS / Linux：~/.claude/settings.json
• Windows：C:\Users\你的用户名\.claude\settings.json

如果 .claude 目录不存在，手动创建即可。

填入配置

用文本编辑器打开 settings.json，填入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的TeamoRouter API Key",
    "ANTHROPIC_BASE_URL": "https://gateway.teamo.ai/v1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-fable-5",
    "API_TIMEOUT_MS": "3000000"
  },
  "model": "sonnet"
}

配置说明：

怎么获取 TeamoRouter API Key？

1. 访问 TeamoRouter 官网 注册账号（邮箱即可，30 秒）
2. 进入控制台 → API Keys → 创建新 Key
3. 支付宝/微信充值（$5 起充，首 $25 五折）
4. 把 Key 填入上面配置中的 ANTHROPIC_AUTH_TOKEN

为什么不用 cc-switch？

cc-switch 是一个优秀的 Claude Code 配置管理工具，但它本质上是帮你修改 settings.json 的图形化界面。如果你只需要接入一个模型供应商（TeamoRouter 已经覆盖了所有主流模型），直接写配置文件比装一个额外的 GUI 工具更轻量、更可控。当然，如果你习惯了 cc-switch 的界面，它也完全支持 TeamoRouter——在 cc-switch 里添加自定义供应商，填入 TeamoRouter 的 endpoint 和 Key 即可。

第三步：启动与验证

启动 Claude Code

# 进入你的项目目录（不要在家目录启动）
cd /你的项目路径

# 启动 Claude Code
claude

首次启动会进行初始化设置——主题选择、安全提示、目录信任——按提示一路回车即可。在信任的目录下，可以使用无权限确认模式：

claude --dangerously-skip-permissions

验证模型是否正确配置

启动后，在 Claude Code 对话中发送一条测试消息：

你现在使用的是哪个模型？请告诉我你的具体版本号。

如果返回的是 claude-sonnet-5（或你配置的默认模型名），说明配置成功。你也可以在对话中用 /model 命令查看和切换已配置的模型。

验证 API 连通性

发送一条需要实际推理的消息：

请用中文解释一下"指针"和"引用"的区别，各举一个代码例子。

如果能正常返回回答，说明 API 通道畅通。如果报错，按下面常见问题排查。

常见问题排查

1. 认证失败 / 401 Unauthorized

原因：API Key 错误或未生效。

解决：

• 检查 settings.json 中的 ANTHROPIC_AUTH_TOKEN 是否正确复制（注意不要有多余的空格或换行）
• 确认 TeamoRouter 账户中已充值（余额为 0 时调用会被拒绝）
• 配置修改后需重启终端，确保环境变量生效

2. 连接超时 / Connection Refused

原因：网络不可达或 endpoint 地址错误。

解决：

• 确认 ANTHROPIC_BASE_URL 填写为 https://gateway.teamo.ai/v1（注意结尾没有斜杠）
• 在终端中用 curl 测试连通性：
  bash复制

  curl -I https://gateway.teamo.ai/v1/models
  

  如果返回 HTTP 200，说明网络可达

3. 返回的模型不是 Claude

原因：模型名称映射错误。

解决：检查 settings.json 中的模型名是否精确匹配 TeamoRouter 支持的模型 ID：

• claude-opus-4-8（不是 claude-opus-4.8）
• claude-sonnet-5（不是 claude-sonnet-4.6）
• claude-fable-5（不是 claude-fable）

4. 400 "thinking type" 错误

原因：第三方 endpoint 不支持 adaptive 思考类型（Claude Code 的默认设置）。

解决：在 settings.json 中添加环境变量：

"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"

或者在 Claude Code 中运行 /config，手动关闭 adaptive thinking。

5. npm 安装报 EACCES 权限错误

原因：macOS/Linux 下 npm 全局安装需要管理员权限，但不推荐使用 sudo。

解决：使用 nvm 管理 Node.js（推荐），或修复 npm 全局路径：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

进阶配置：多模型切换策略

配置好基础连接后，可以根据不同任务类型切换模型来优化成本：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的TeamoRouter API Key",
    "ANTHROPIC_BASE_URL": "https://gateway.teamo.ai/v1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-fable-5",
    "API_TIMEOUT_MS": "3000000"
  },
  "model": "sonnet"
}

推荐使用策略：

• 日常编码 / 代码审查 / 文档生成：sonnet（Claude Sonnet 5）——性价比最高，编程能力业界领先
• 复杂架构设计 / 深度算法推理：opus（Claude Opus 4.8）——最强推理，单次成本更高但值得
• 快速问答 / 简单格式转换：用 /model 切换到 haiku（Claude Fable 5）——成本仅为 Opus 的约 1/5

在对话中随时用 /model 命令即可切换，无需重启 Claude Code。

进阶技巧：定制你的 Claude Code 工作环境

配置 CLAUDE.md 提升协作效率

Claude Code 支持通过 ~/.claude/CLAUDE.md 文件定义你的工作偏好——这是一个被 Claude Code 在每次对话中自动读取的"个人说明书"。合理配置后能让 Claude Code 在风格和规范上更贴合你的习惯。

推荐配置示例：

# Claude Code 个人配置

## 沟通风格
- 使用中文回复
- 代码注释用中文，变量名和函数名用英文
- 解释技术概念时先给一句话总结，再展开细节

## 代码规范
- 遵循项目已有的 ESLint/Prettier 配置
- 新增函数必须有 JSDoc 注释
- React 组件优先使用函数组件 + Hooks
- 不引入超过 50KB 的第三方依赖，除非必要

## 安全红线
- 删除文件前必须确认
- 不要修改 .env 和密钥文件
- 数据库操作必须有 where 条件
- 不执行 rm -rf 或任何不可逆的操作

## 工程习惯
- 做完一个功能后主动运行 lint 和测试
- commit message 使用中文，格式：[类型] 简短描述
- 重构前先解释改动范围和原因

Claude Code 会在每次对话开始时读取这个文件，让你的 AI 编程助手真正"懂你"的工作方式。

项目级 settings.json 配置

除了全局的 ~/.claude/settings.json，你还可以在每个项目目录下创建 .claude/settings.json，针对不同项目使用不同的模型策略：

• 生产级后端项目：默认使用 Opus 4.8，确保代码质量和架构决策的严谨性
• 前端快速迭代项目：默认使用 Sonnet 5，平衡速度和质量
• 脚本工具 / 个人项目：默认使用 Fable 5，追求响应速度和低成本

项目级配置会覆盖全局配置中的同名字段，非常灵活。

在团队中使用 TeamoRouter + Claude Code

如果你的团队有多个开发者都在用 Claude Code，TeamoRouter 的团队方案可以提供：

• 按项目分 Key：为每个项目创建独立的 API Key，各项目的用量和成本独立追踪
• 用量仪表盘：实时查看每个 Key / 每个模型的调用量和费用，方便做成本分摊
• 预算预警：设置每 Key 的月度预算上限，超限自动提醒，避免账单失控
• 权限控制：不同成员可以授予不同的 Key 访问权限，防止 Key 滥用

对于 Tech Lead 来说，这意味着你可以给团队的每个开发者配置好 Claude Code + TeamoRouter，然后在一个控制台里看到所有人的用量和成本——不再需要用 Excel 手工统计。

和常见替代方案的对比

为了帮你做选择，这里总结一下 Claude Code "直接配 TeamoRouter endpoint"和其他常见方案的差异：

如果你是开发者，想用真正的 Claude 模型来编程，直接配 TeamoRouter endpoint 是最轻量、最高性价比的方案。不需要装任何额外工具——一个 JSON 文件改完就能用，成本是官方的五分之一不到，网络零配置。

成本控制建议

通过 TeamoRouter 使用 Claude Code 的成本参考（以 Claude Sonnet 5 为例，开启缓存）：

• 轻度使用（每天 50-100 次对话）：约 $10-20/月
• 中度使用（每天 200-500 次对话，正常开发者）：约 $30-50/月
• 重度使用（全天候 Agent 开发）：约 $80-150/月

对比官方直充：同样的用量，走 TeamoRouter 的价格为官方定价的 1.8 折，且缓存命中率达到 99%+，长对话场景节省尤为明显——当你和 Claude Code 在同一个会话中持续协作数小时时，后续每轮对话的成本仅为首轮的约 10%。

开始配置你的 Claude Code，首 $25 五折 →