# 国内安装使用 Claude Code 完整教程：安装、登录、中转配置

> Claude Code 国内怎么装？没有海外卡怎么用上 Claude？本教程覆盖 npm 安装、账号登录、ANTHROPIC_BASE_URL 中转接入、Claude Code Router 多模型切换的完整流程。
> 更新于 2026-08-04 · 难度 初级 · 来源 https://aicdks.com/guides/install-claude-code-china

Claude Code 是 Anthropic 官方的命令行 AI 编程工具，和 Codex 定位类似，但很多人认为它在复杂重构、长任务上表现更强。国内使用它的门槛和 Codex 一样：网络、账号、支付。这篇给出三条可行路线，从零跑通。

## 第一步：安装

先装 Node.js 18+（方法见 [Codex 教程第一步](/guides/install-codex-cli-china)），然后：

```bash
npm install -g @anthropic-ai/claude-code
claude --version
```

- macOS / Linux / WSL2 直接可用；
- Windows 原生也支持（需要安装 Git for Windows），但新手仍推荐 WSL2，坑更少。

## 第二步：选一条登录路线

### 路线 A：官方订阅（Pro / Max）

```bash
claude
```

首次运行选「Subscription」登录，浏览器打开 claude.ai 授权。需要 Claude Pro（$20/月）或 Max（$100+/月）订阅——用量大选 Max。

国内障碍和 ChatGPT 一样：注册要海外手机号、付费要海外卡。对应解决：买[Claude 成品号/代充](/category/ai-账号与服务-claude)，或先看懂[账号类型区别](/guides/chatgpt-plus-account-types)（逻辑通用）再挑。

### 路线 B：官方 API Key

在 console.anthropic.com 创建 API Key，按 token 计费：

```bash
export ANTHROPIC_API_KEY="sk-ant-..."
claude
```

适合用量不规律的开发者，但同样需要海外支付方式充值。

### 路线 C：API 中转（国内最常用）

中转服务提供一个兼容 Anthropic 协议的国内可达接口（原理见[API 中转教程](/guides/what-is-api-relay)）。买到中转额度后只需设置两个环境变量：

```bash
export ANTHROPIC_BASE_URL="https://你的中转地址"
export ANTHROPIC_AUTH_TOKEN="你的中转key"
claude
```

写进 `~/.bashrc` 或 `~/.zshrc` 就一劳永逸。这条路线不需要 Anthropic 账号、不需要海外卡，网络要求也最低，是国内起步最快的方式。选购时认准标明「支持 Claude Code」的[中转额度商品](/category/api-中转与额度-claude-额度)。

## 第三步（可选）：Claude Code Router 多模型切换

想在 Claude Code 里同时接多家模型（官方 Claude、DeepSeek、Gemini、各家中转），用开源的 Claude Code Router 统一管理：

```bash
npm install -g @musistudio/claude-code-router
ccr code   # 代替 claude 启动
```

在 `~/.claude-code-router/config.json` 里配置多个 provider 和路由规则，比如「后台任务走便宜模型、复杂推理走 Claude」，能显著省额度。它本质上就是跑在你本机的一个小中转站。

## 第四步：基本用法

```bash
cd my-project
claude "阅读这个仓库，总结架构，然后把 utils 里的重复代码抽成公共函数"
```

实用要点：

- 项目根目录放 `CLAUDE.md`，写清构建命令、代码规范，Claude Code 每次都会读；
- `/init` 让它自动生成 CLAUDE.md；
- `/compact` 压缩上下文继续长任务；
- 权限确认嫌烦可用 `claude --dangerously-skip-permissions`（仅限可信目录）。

## 常见报错排查

| 现象 | 解决 |
| --- | --- |
| 登录浏览器页打不开 | 走路线 C 中转，绕开对 claude.ai 的直连要求 |
| `Invalid API key` | 检查 BASE_URL 和 TOKEN 是否配对（中转 key 不能配官方地址） |
| 回复到一半断流 | 网络抖动；中转路线选国内直连优化的服务商 |
| Windows 下命令不存在 | 确认 npm 全局 bin 目录在 PATH 里，或改用 WSL2 |

## 下一步

平台细节看专篇：[Windows（原生 vs WSL）](/guides/claude-code-windows-install)、[macOS / Linux](/guides/claude-code-macos-linux-install)；不想用命令行看 [Claude Desktop 桌面端](/guides/claude-desktop-guide)或 [VS Code 插件](/guides/vscode-ai-extensions)。想让 Claude Code 通过 skills（技能）长期自动化推进科研和项目开发，看：[用 Claude Code / Codex 做科研自动化](/guides/ai-coding-for-research) 与 [skills 进阶教程](/guides/claude-code-skills-research-workflow)。遇到报错看 [国内常见报错排错指南](/guides/codex-claude-code-troubleshooting)；多供应商切换看 [CC Switch 使用教程](/guides/cc-switch-tutorial)。