夜雨聆风> 一篇搞定安装、配置、国内模型接入，建议收藏。
---
## 一、Claude Code 是什么？
Claude Code 是 Anthropic 推出的**命令行 AI 编程助手**。它不像 Copilot 那样只在编辑器里补全代码，而是可以直接在你的项目里**读文件、写代码、跑命令、改 Bug、提交 Git**——像一个真正坐在你旁边的资深程序员。
更重要的是：**它支持接入任何兼容 Anthropic 协议的第三方大模型**，包括 DeepSeek、通义千问、智谱 GLM、Kimi 等国产模型。这意味着你不用翻墙、不用海外信用卡，也能享受顶级 AI 编程体验。
---
## 二、安装 Claude Code
### 2.1 方式一：官方原生安装器（2026 推荐）
Anthropic 在 2026 年 1 月推出了原生安装器，**不再需要装 Node.js**，而且支持自动更新。
**macOS / Linux / WSL：**
```bash
curl -fsSL https://claude.ai/install.sh | bash
```
**Windows PowerShell：**
```powershell
irm https://claude.ai/install.ps1 | iex
```
安装完成后，`claude` 命令会自动加入 PATH。
---
### 2.2 方式二：npm 安装（需要 Node.js）
如果你习惯用 npm，或者需要同时管理多个版本：
```bash
# 先确认 Node.js 版本 ≥ 18
node --version
# 使用国内镜像加速安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
# 验证安装
claude --version
```
> **注意**：npm 方式在 2026 年已被官方标记为"遗留方式"，不再推荐作为首选。但如果你在国内网络环境下 curl 官方脚本速度慢，npm + 国内镜像反而更稳。
---
### 2.3 方式三：Homebrew（macOS）
```bash
brew install --cask claude-code
```
缺点是不会自动更新，需要手动 `brew upgrade`。
---
### 2.4 安装后验证
```bash
# 检查版本
claude --version
# 运行诊断（排查环境问题）
claude doctor
```
---
## 三、第一次启动
进入你的项目目录，运行：
```bash
cd /你的项目路径
claude
```
首次运行会弹出浏览器进行 OAuth 登录。登录成功后会生成一个会话令牌，之后就不用重复登录了。
进入交互界面后，强烈建议先执行：
```
/init
```
这个命令会扫描你的项目结构，自动生成一份 `CLAUDE.md` 文件，告诉 AI 你的项目是干什么的、用了什么技术栈、有哪些约定——**这是提升 AI 输出质量最关键的一步。**
---
## 四、免登录配置（搭配国内模型必做）
如果你想跳过 Anthropic 账号登录，直接使用国内模型：
```bash
# 创建配置目录
mkdir -p ~/.claude
# 标记已完成引导
echo '{"hasCompletedOnboarding": true}' > ~/.claude/.claude.json
```
注意：这里的 `.claude.json` 文件位置在 `~/.claude/` 目录下，不是 home 根目录。不同版本路径可能略有差异，如果无效，试一下放在 `~/.claude.json`。
---
## 五、接入国内大模型——核心配置
这是本文的重点。Claude Code 通过三个环境变量来控制使用哪个模型：
| 环境变量 | 含义 |
|---------|------|
| `ANTHROPIC_BASE_URL` | API 服务地址 |
| `ANTHROPIC_AUTH_TOKEN` | API 密钥 |
| `ANTHROPIC_MODEL` | 模型名称 |
配置文件位于 `~/.claude/settings.json`。
---
### 5.1 智谱 GLM
智谱提供了**原生 Anthropic 协议接口**，兼容性最好，推荐作为首选。
```json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的智谱API Key",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air"
}
}
```
API Key 获取地址：https://open.bigmodel.cn → 控制台 → API Keys
---
### 5.2 阿里百炼（通义千问 Qwen）
```json
{
"alwaysThinkingEnabled": false,
"env": {
"ANTHROPIC_API_KEY": "你的百炼API Key",
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.5-flash",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder-next"
}
}
```
⚠️ 注意三点：
- 认证字段用 `ANTHROPIC_API_KEY`（不是 `ANTHROPIC_AUTH_TOKEN`）
- 必须设置 `"alwaysThinkingEnabled": false`
- Base URL 末尾是 `/apps/anthropic`，不要写成 `/compatible-mode/v1`
API Key 获取地址：https://dashscope.console.aliyun.com → API-KEY 管理
---
### 5.3 DeepSeek
```json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_MODEL": "deepseek-chat"
}
}
```
DeepSeek 目前只有一个主力模型 `deepseek-chat`（V3 系列），所以三档可以指向同一个。如果要做复杂推理任务，可以单独切到 `deepseek-reasoner`（R1 系列）。
API Key 获取地址：https://platform.deepseek.com → API Keys
---
### 5.4 Kimi（月之暗面）
```json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的Kimi API Key",
"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_MODEL": "kimi-k2.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5",
"CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k2.5",
"ENABLE_TOOL_SEARCH": "0"
}
}
```
⚠️ Kimi 需要把所有模型变量全部映射到同一个模型名，否则 Claude Code 会在不同任务时尝试切换模型导致报错。
---
### 5.5 豆包（字节跳动）
```json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的豆包API Key",
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/compatible",
"ANTHROPIC_MODEL": "doubao-seed-code-preview-latest"
}
}
```
API Key 获取地址：https://console.volcengine.com/ark → API Keys
---
### 5.6 MiniMax
```json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的MiniMax API Key",
"ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
"ANTHROPIC_MODEL": "MiniMax-M2.7"
}
}
```
---
## 六、临时环境变量方式（快速测试，不写文件）
如果你只是想试一下某个模型，不想改配置文件：
```bash
ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic" \
ANTHROPIC_AUTH_TOKEN="你的API Key" \
ANTHROPIC_MODEL="glm-4.7" \
claude
```
适合快速 A/B 测试不同模型。
---
## 七、进阶方案：Claude Code Router（多模型智能路由）
上面说的是"固定用一个模型"的方案。如果你想**根据任务类型自动切换不同模型**，就需要 Claude Code Router。
### 7.1 安装
```bash
npm install -g @moqimoqidea/claude-code-router
```
### 7.2 配置文件 `~/.claude-code-router/config.json`
```json
{
"API_TIMEOUT_MS": 600000,
"Providers": [
{
"name": "deepseek",
"api_base_url": "https://api.deepseek.com/chat/completions",
"api_key": "sk-你的密钥",
"models": ["deepseek-chat", "deepseek-reasoner"],
"transformer": {
"use": ["deepseek"],
"deepseek-chat": { "use": ["tooluse"] }
}
},
{
"name": "modelscope",
"api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
"api_key": "ms-你的密钥",
"models": [
"Qwen/Qwen3-Coder-480B-A35B-Instruct",
"ZhipuAI/GLM-4.5"
],
"transformer": {
"use": [["maxtoken", { "max_tokens": 65536 }], "enhancetool"]
}
}
],
"Router": {
"default": "deepseek,deepseek-chat",
"think": "deepseek,deepseek-reasoner",
"longContext": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct",
"longContextThreshold": 60000
}
}
```
路由策略说明：
| 路由键 | 触发条件 | 适合放什么模型 |
|--------|---------|--------------|
| `default` | 日常编码对话 | 速度快、成本低的模型 |
| `think` | 复杂推理 / `/think` 命令 | 推理能力强的模型 |
| `longContext` | 上下文超过阈值 | 支持长上下文的模型 |
| `background` | 子智能体后台任务 | 便宜耐用的模型 |
### 7.3 启动
```bash
ccr code
```
进入后和原生 Claude Code 体验一致，但背后会根据任务自动切换模型。
---
## 八、多套配置并存（一键切换模型）
在日常使用中，你可能希望"复杂任务用 Opus，日常用 DeepSeek，省钱用 Qwen"。可以通过多个配置文件 + alias 实现：
```bash
# 创建多份配置
cp ~/.claude/settings.json ~/.claude/settings-deepseek.json
cp ~/.claude/settings.json ~/.claude/settings-qwen.json
# 编辑各文件填入对应模型配置
# settings-deepseek.json → DeepSeek
# settings-qwen.json → 通义千问
# 在 ~/.bashrc 或 ~/.zshrc 中添加别名
alias claude-ds="claude --settings ~/.claude/settings-deepseek.json"
alias claude-qw="claude --settings ~/.claude/settings-qwen.json"
# 使别名生效
source ~/.bashrc
```
使用时就很简单了：
```bash
claude-ds # 用 DeepSeek
claude-qw # 用通义千问
```
---
## 九、在 VS Code 中使用
如果你习惯 VS Code，可以安装 Claude Code 的 VS Code 插件。插件里同样支持国内模型配置：
1. 在 VS Code 扩展市场搜索并安装 **"Claude Code"** 插件
2. 打开设置（`Cmd+,` / `Ctrl+,`），搜索 `claudeCode`
3. 在 `Claude Code: Environment Variables` 中设置：
```
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
ANTHROPIC_AUTH_TOKEN=你的API Key
ANTHROPIC_MODEL=glm-4.7
```
4. 在 `Claude Code: Selected Model` 中选择对应模型
---
## 十、常见问题排查
### Q1：配置了 settings.json 但没生效？
按顺序排查：
1. **JSON 格式对不对？**——多一个逗号或少一个引号都会导致整个文件被忽略。用 `python -m json.tool ~/.claude/settings.json` 验证
2. **路径对不对？**——是 `~/.claude/settings.json`，不是 `~/settings.json` 也不是 `~/.claude/config.json`
3. **有没有 `hasCompletedOnboarding`？**——确认 `~/.claude/.claude.json` 内容为 `{"hasCompletedOnboarding": true}`
4. **重启了吗？**——改配置后必须退出 Claude Code 重新进入，环境变量不会热加载
### Q2：总是提示 "Authentication required"？
- 检查 `ANTHROPIC_AUTH_TOKEN` 的值是否正确（有没有多空格、有没有过期）
- 有些平台用 `ANTHROPIC_API_KEY`，有些用 `ANTHROPIC_AUTH_TOKEN`，以各平台文档为准
- Base URL 末尾不要随意加 `/v1`
### Q3：工具调用经常失败、编辑不准确？
这是使用第三方模型的**正常现象**。Claude Code 的编辑、工具调用等深度功能对 Claude 原生模型优化最好。第三方模型中，智谱 GLM 的兼容性目前最好；DeepSeek 和 Qwen 在简单任务中表现也不错，但复杂重构建议切回 Claude 原版。
### Q4：修改代码后出现死循环编辑？
在 `settings.json` 中设置：
```json
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"ENABLE_TOOL_SEARCH": "0"
```
可以缓解部分第三方模型的兼容性问题。
### Q5：上下文超出限制怎么办？
在 Claude Code 中输入：
```
/compact
```
这会压缩当前对话历史，释放上下文空间。
---
## 十一、模型选型参考（2026 年实测）
| 场景 | 推荐模型 | 理由 |
|------|---------|------|
| 日常编码、小 Bug | DeepSeek-V3 / Qwen3.5-Flash | 速度快、成本低 |
| 中文注释/文档 | GLM-5 / Qwen3.5-Plus | 中文理解最优 |
| 复杂架构设计 | Claude Opus 4.5（原始） | 代码质量天花板 |
| 省钱大量调用 | DeepSeek-V3 | 目前性价比最高 |
| 长上下文项目 | GLM-5（1M） / Kimi-K2.5 | 原生长窗口支持 |
---
## 总结
Claude Code 不是只能绑在 Anthropic 官方服务上用。通过修改 `settings.json` 的三个核心变量（Base URL、API Key、Model），你可以接入几乎任何兼容协议的国内大模型。
核心就三步：
1. **安装** → `curl -fsSL https://claude.ai/install.sh | bash`
2. **配模型** → 修改 `~/.claude/settings.json`
3. **启动** → `claude`，开始干活
配合 Router 还能实现多模型智能切换，兼顾质量与成本。
---
> 觉得有用？点个「在看」，转发给你身边还在为 AI 编程工具发愁的同事吧 👇
