Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，支持代码生成、调试、重构、项目分析、文件读写等强大的 Agent 能力。但由于 Claude 官方服务未对中国大陆地区开放，直接安装使用会遇到地区限制、强制登录等问题。

本教程基于国内合规大模型平台 + Anthropic 协议兼容接口实现可用配置，全程合规、可直接用于开发环境。

⚠️ 重要声明

1. 本文不引导、不提供任何违规跨境网络访问方式
2. 不使用 Claude 官方模型，仅接入国内依法合规 AI 平台
3. 用户需自行实名认证、申请 API Key，遵守平台规则
4. 本文仅做技术演示，使用行为需符合法律法规

---

目录

1. 环境准备
2. 安装 Claude Code 客户端
3. 跳过登录与地区检查
4. API 协议适配说明（必读）
5. 国内兼容平台配置清单
6. WSL2 环境配置路径
7. 完整配置文件
8. 模型选择避坑（Agent 专用）
9. 安全使用提醒
10. 常见错误与解决方案
11. 一键快速配置脚本

---

一、环境准备

1.1 系统要求

• Windows 10+/WSL2(Ubuntu)/macOS/Linux
• Git（项目文件识别依赖）
• Node.js ≥ 18.x

1.2 快速安装依赖

Windows（PowerShell）

powershell

winget install --id Git.Git -e --source winget
winget install OpenJS.NodeJS --version 22

macOS

bash

运行

brew install git node

---

二、安装 Claude Code 客户端

官方安装脚本需要访问 claude.ai，未开放地区会直接提示地区不可用。

合规使用方式：

• 在具备合法访问权限的环境完成安装
• 使用社区可信分发的二进制程序包

安装完成后验证：

bash

运行

claude --version

---

三、跳过登录与地区检查

Claude Code 启动默认强制：地区校验 → 账号登录 → 首次引导。通过本地配置文件可安全跳过（纯本地行为，不涉及服务端绕过）。

3.1 创建配置目录

Windows

powershell

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

Linux/macOS/WSL2

bash

运行

mkdir -p ~/.claude

3.2 创建并编辑配置文件

powershell

notepad "$env:USERPROFILE\.claude\settings.json"

基础配置（跳过登录）

json

{
  "hasCompletedOnboarding": true
}

---

四、API 协议适配说明（必读！）

Claude Code 底层强制调用 Anthropic 原生协议 /v1/messages不兼容 OpenAI 格式接口！

如果平台只支持 OpenAI 协议，直接报错：

• 404 Not Found
• API Error
• Unsupported model

✅ 必须选择：支持 Anthropic 协议转发的平台

---

五、国内合规兼容平台配置

表格

平台	Anthropic 兼容接口地址	推荐模型
硅基流动	https://api.siliconflow.cn	Qwen/Qwen3-235B-A22B-Instruct-2507
智谱 AI	https://open.bigmodel.cn/api/anthropic	glm-4.5-air
DeepSeek	https://api.deepseek.com/anthropic	deepseek-chat
MiniMax	https://api.minimaxi.com/anthropic	MiniMax-M2.5

---

六、WSL2 环境配置路径

很多开发者在 Windows 下使用 WSL2 开发，路径对应关系：

• WSL2 内路径：~/.claude/settings.json
• 对应 Windows 路径：$env:USERPROFILE\.claude\settings.json

两个环境共用同一份配置，无需重复设置。

---

七、完整配置文件（直接复制）

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn",
    "ANTHROPIC_API_KEY": "sk-你自己申请的API密钥",
    "ANTHROPIC_MODEL": "Qwen/Qwen3-235B-A22B-Instruct-2507"
  },
  "hasCompletedOnboarding": true
}

保存后执行：

bash

运行

cd 你的项目目录
claude

出现欢迎界面即配置成功。

---

八、模型选择避坑指南（Agent 关键）

Claude Code 是强智能体（Agent），会自动执行：ls/cat/grep/cd/文件读写/项目分析

弱模型会出现：

• 无限复读
• 不执行工具调用
• 理解错误、逻辑混乱
• 频繁报错中断

✅ 推荐强推理模型

• Qwen3-235B
• DeepSeek-V3 / R1
• GLM-4.5 Air
• MiniMax-M2.5

❌ 不推荐

• 小参数量基础模型
• 指令遵循能力差的模型

---

九、安全使用提醒（非常重要）

1. 请勿将包含 API Key 的 settings.json 上传至 GitHub/Gitee 等公开仓库，极易导致密钥泄露被盗刷。
2. 在项目 .gitignore 中添加：

plaintext

.claude/

1. 定期轮换 API Key，不要在公共设备保存明文密钥。

---

十、常见错误与解决方案

10.1 404 Not Found

原因：平台不支持 Anthropic /v1/messages 协议解决：更换本文推荐的兼容平台

10.2 401 Unauthorized

原因：API Key 错误、过期、未启用解决：重新生成密钥，检查格式与权限

10.3 400 Missing Model

原因：模型名称错误（大小写敏感）解决：对照平台文档复制准确模型名

10.4 Agent 复读、不执行操作

原因：模型推理能力不足解决：更换强推理模型

10.5 地区不可用（安装阶段）

原因：官方服务未对当前地区开放解决：仅在合规可访问环境安装客户端

---

十一、Windows 一键快速配置

powershell

# 创建配置目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

# 写入配置（替换自己的API Key）
@'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn",
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "Qwen/Qwen3-235B-A22B-Instruct-2507"
  },
  "hasCompletedOnboarding": true
}
'@ | Out-File -FilePath "$env:USERPROFILE\.claude\settings.json" -Encoding utf8

# 启动 Claude Code
claude

---

十二、日常使用命令

bash

运行

claude          # 启动
/cost           # 查看 token 消耗
/clear          # 清空历史
/model          # 临时切换模型
/exit           # 退出

---

总结

• Claude 官方服务国内不可直接使用，本文为合规替代方案
• 必须使用支持 Anthropic 协议的平台，否则 404
• 必须使用强推理模型才能正常使用 Agent 能力
• 配置完成后可实现代码编写、调试、重构、项目分析全功能

---

本文为原创技术配置教程，仅用于学习交流，严禁用于非法用途。如有平台接口变动，请以各平台官方文档为准。