文章目录
目录
- 一、环境准备
- 1.1 系统要求
- 1.2 快速安装依赖
- 二、安装 Claude Code 客户端
- 三、跳过登录与地区检查
- 3.1 创建配置目录
- 3.2 创建并编辑配置文件
- 四、API 协议适配说明（必读！）
- 五、国内合规兼容平台配置
- 六、WSL2 环境配置路径
- 七、完整配置文件（直接复制）
- 八、模型选择避坑指南（Agent 关键）
- 九、安全使用提醒（非常重要）
- 十、常见错误与解决方案
- 十一、Windows 一键快速配置
- 十二、日常使用命令
- 总结
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，支持代码生成、调试、重构、项目分析、文件读写等强大的 Agent 能力。但由于 Claude 官方服务未对中国大陆地区开放，直接安装使用会遇到地区限制、强制登录等问题。
本教程基于国内合规大模型平台 + Anthropic 协议兼容接口实现可用配置，全程合规、可直接用于开发环境。
重要声明
- 本文不引导、不提供任何违规跨境网络访问方式
- 不使用 Claude 官方模型，仅接入国内依法合规 AI 平台
- 用户需自行实名认证、申请 API Key，遵守平台规则
- 本文仅做技术演示，使用行为需符合法律法规
- Windows 10+/WSL2(Ubuntu)/macOS/Linux
- Git（项目文件识别依赖）
- Node.js ≥ 18.x
Windows（PowerShell）
winget install --id Git.Git -e --source winget winget install OpenJS.NodeJS --version 22
macOS
brew install git node
官方安装脚本需要访问 claude.ai，未开放地区会直接提示地区不可用。
合规使用方式：
- 在具备合法访问权限的环境完成安装
- 使用社区可信分发的二进制程序包
安装完成后验证：
claude --version
Claude Code 启动默认强制：地区校验 → 账号登录 → 首次引导。通过本地配置文件可安全跳过（纯本地行为，不涉及服务端绕过）。
Windows
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE.claude"
Linux/macOS/WSL2
mkdir -p ~/.claude
notepad "$env:USERPROFILE.claudesettings.json"
基础配置（跳过登录）
{
"hasCompletedOnboarding": true
}
Claude Code 底层强制调用 Anthropic 原生协议 /v1/messages不兼容 OpenAI 格式接口！
如果平台只支持 OpenAI 协议，直接报错：
404 Not FoundAPI ErrorUnsupported 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 |
很多开发者在 Windows 下使用 WSL2 开发，路径对应关系：
- WSL2 内路径：
~/.claude/settings.json - 对应 Windows 路径：
$env:USERPROFILE.claudesettings.json
两个环境共用同一份配置，无需重复设置。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.siliconflow.cn",
"ANTHROPIC_API_KEY": "sk-你自己申请的API密钥",
"ANTHROPIC_MODEL": "Qwen/Qwen3-235B-A22B-Instruct-2507"
},
"hasCompletedOnboarding": true
}
保存后执行：
cd 你的项目目录 claude
出现欢迎界面即配置成功。
Claude Code 是强智能体（Agent），会自动执行：ls/cat/grep/cd/文件读写/项目分析
弱模型会出现：
- 无限复读
- 不执行工具调用
- 理解错误、逻辑混乱
- 频繁报错中断
推荐强推理模型
- Qwen3-235B
- DeepSeek-V3 / R1
- GLM-4.5 Air
- MiniMax-M2.5
不推荐
- 小参数量基础模型
- 指令遵循能力差的模型
请勿将包含 API Key 的 settings.json 上传至 GitHub/Gitee 等公开仓库，极易导致密钥泄露被盗刷。
在项目 .gitignore 中添加：
.claude/
定期轮换 API Key，不要在公共设备保存明文密钥。
1.404 Not Found
原因：平台不支持 Anthropic /v1/messages 协议解决：更换本文推荐的兼容平台
2.401 Unauthorized
原因：API Key 错误、过期、未启用解决：重新生成密钥，检查格式与权限
3.400 Missing Model
原因：模型名称错误（大小写敏感）解决：对照平台文档复制准确模型名
4.Agent 复读、不执行操作
原因：模型推理能力不足解决：更换强推理模型
5.地区不可用（安装阶段）
原因：官方服务未对当前地区开放解决：仅在合规可访问环境安装客户端
# 创建配置目录
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.claudesettings.json" -Encoding utf8
# 启动 Claude Code
claude
claude # 启动
/cost # 查看 token 消耗
/clear # 清空历史
/model # 临时切换模型
/exit # 退出
- Claude 官方服务国内不可直接使用，本文为合规替代方案
- 必须使用支持 Anthropic 协议的平台，否则 404
- 必须使用强推理模型才能正常使用 Agent 能力
- 配置完成后可实现代码编写、调试、重构、项目分析全功能
以上就是2026年Claude Code国内合规使用与配置的完整指南的详细内容，更多关于Claude Code使用与配置的资料请关注风君子博客其它相关文章！