大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



本教程基于国内合规大模型平台 + 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.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.claudesettings.json" 

基础配置（跳过登录）

json

 { "hasCompletedOnboarding": true } 

---

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

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

• 404 Not Found
• API Error
• Unsupported model

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

---

表格

---

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

• WSL2 内路径：~/.claude/settings.json
• 对应 Windows 路径：$env:USERPROFILE.claudesettings.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 

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

---

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 地区不可用（安装阶段）

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

---

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.claudesettings.json" -Encoding utf8 # 启动 Claude Code claude 

---

bash

运行

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

---

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

---

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