Claude Code 国内合规使用教程(2026年最新分享)

目录

• ✅ 二、获取 API 令牌（国内网络环境可用方案）
• 方案 A（官方方式）：Anthropic API Key
• 方案 B（国内常用）：第三方中转服务（示例：DKAPI）
• ✅ 三、配置环境变量（强烈推荐写入配置文件）
• 1）Linux / macOS：临时设置（仅当前终端有效）
• 2）Linux / macOS：永久设置（推荐）
• ✅ 四、启动 Claude Code（首次启动说明）
• ✅ 五、常用命令速查表
• ✅ 六、进阶功能
• 1）接入外部工具（MCP：模型上下文协议）
• 2）自定义团队快捷命令（项目共享）
• ✅ 七、国内使用常见问题与排查建议
• ✅ 八、实战案例：1 分钟生成扫雷小游戏（HTML + JS）
• ✅ 总结（一句话版本）

适用 Windows / macOS / Linux，并包含 国内网络环境可用方案与常见问题排查。

Claude Code 是 Anthropic 官方的终端 AI 编程助手，可用于：写代码、解释代码、重构、生成脚本、审查 PR、运行测试、维护项目记忆（CLAUDE.md）等。

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
npm -v

macOS（Homebrew）

brew install node
node -v
npm -v

Windows（推荐）

• 到 Node.js 官网下载安装 LTS
• 安装后在 PowerShell / CMD 执行：

node -v
npm -v

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

如果看到类似 v0.3.2 的版本号，说明安装成功。

如果你用的是 macOS/Linux 且权限报错，可尝试：

sudo npm install -g @anthropic-ai/claude-code

或使用 nvm 管理 Node 避免 sudo（更推荐）。

如果你可以正常访问 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

基本步骤（通用，不强绑定某一家）

1. 注册并登录中转平台
2. 在控制台创建 API Token（一般以 sk- 开头）
3. 记录 Token 与 Base URL（通常平台会提供类似 https://xxx.xxx 的地址）

Claude Code 通过环境变量读取 Token 与 API 地址：

• ANTHROPIC_AUTH_TOKEN：你的 API Key / Token
• ANTHROPIC_BASE_URL：第三方中转地址（如果用官方则通常不需要设置）

export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_BASE_URL="https://api.dakeai.cc"

bash 用户

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.dakeai.cc"' >> ~/.bashrc
source ~/.bashrc

zsh 用户（macOS 默认）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.dakeai.cc"' >> ~/.zshrc
source ~/.zshrc

3）Windows：永久设置（推荐）

PowerShell（当前用户）

setx ANTHROPIC_AUTH_TOKEN "sk-你的令牌"
setx ANTHROPIC_BASE_URL "https://api.dakeai.cc"

设置后请重新打开一个新的 PowerShell / 终端窗口再运行 Claude Code。

验证是否生效：

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

进入你的项目目录：

cd your-project-folder
claude

首次启动通常会出现交互式引导，包括：

• 选择主题（Theme）
• 确认安全提示
• 使用默认 Terminal 设置
• 信任当前工作目录（Trust current directory）

建议：只在可信项目里选择 Trust，避免在陌生目录中授权过多访问。

命令	作用
claude	启动交互式会话
claude -p "生成一个登录页面"	一次性执行 prompt（适合脚本/自动化）
claude –continue	恢复上一次会话
/clear	清空当前会话上下文
/cost	查看 token / 费用消耗
/memory	编辑项目记忆文件（通常是 CLAUDE.md）
/review	请求代码审查（review）
/config	查看或修改配置
claude update	更新 Claude Code 到最新版

MCP 可以让 Claude Code 调用外部服务或工具，例如数据库、浏览器自动化等。

添加 MySQL（示例）

claude mcp add mysql npx @benborla29/mcp-server-mysql 
  -e MYSQL_HOST=localhost 
  -e MYSQL_USER=root 
  -e MYSQL_PASS=你的密码 
  -e MYSQL_DB=test

添加 Playwright（网页自动化）

claude mcp add playwright npx '@playwright/mcp@latest'

提醒：MCP 工具可以访问你的系统/网络资源，务必只安装可信来源。

在项目根目录创建：

./.claude/commands.json

示例：

{
  "run-tests": "npm run test",
  "deploy": "npm run build && rsync -av dist/ server:/var/www/"
}

之后你可以在 Claude Code 中快速调用这些命令（团队共享同一套流程非常方便）。

问题	可能原因	解决方法
API 报错 / 连接超时	网络不稳定 / 中转拥堵	重试、切换网络、换中转节点
显示 offline	仅状态提示异常	通常不影响使用，可继续
fetch failed	DNS/网络/代理问题	开启全局代理、切换网络、检查 BASE_URL 是否可访问
Token 无效	Token 未设置或复制错误	检查环境变量是否生效（重新打开终端）
权限/目录信任问题	未 trust 项目目录	在可信项目下重新启动并信任

额外安全建议（强烈推荐加入教程里）：

• 不要把 Token 写进代码仓库（Git）
• 不要在 Claude 中粘贴生产密钥、数据库密码、客户数据
• 使用第三方中转时，只用于学习/非敏感项目

一条命令生成：

claude -p "用 HTML+JS 写一个扫雷小游戏，支持点击格子、右键标记地雷，带计时和重新开始按钮"

保存生成文件后运行（Python 示例）：

python -m http.server 8000

浏览器访问：

• http://localhost:8000

通常生成 + 运行速度非常快，成本视模型和输出长度而定。

Claude Code = 终端里的 Claude AI：写代码、重构、查文档、审查、测试一条龙；国内网络环境可通过官方或第三方中转接入使用。

到此这篇关于Claude Code 国内合规使用教程(2026年最新分享)的文章就介绍到这了,更多相关Claude Code 国内使用内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！