Claude Code 国内合规使用教程(2026年最新分享)
适用 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
2)安装 Claude Code(全局安装)
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(更推荐)。
✅ 二、获取 API 令牌(国内网络环境可用方案)
方案 A(官方方式):Anthropic API Key
如果你可以正常访问 Anthropic 官方并能付款,这是最稳妥的方式。
方案 B(国内常用):第三方中转服务(示例:DKAPI)
提示:第三方中转服务并非官方,优点是国内更容易直连、可能有试用额度;缺点是安全、稳定性、隐私都取决于服务商。
例如
| 平台 | 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 |
基本步骤(通用,不强绑定某一家)
- 注册并登录中转平台
- 在控制台创建 API Token(一般以
sk-开头) - 记录 Token 与 Base URL(通常平台会提供类似
https://xxx.xxx的地址)
✅ 三、配置环境变量(强烈推荐写入配置文件)
Claude Code 通过环境变量读取 Token 与 API 地址:
ANTHROPIC_AUTH_TOKEN:你的 API Key / TokenANTHROPIC_BASE_URL:第三方中转地址(如果用官方则通常不需要设置)
1)Linux / macOS:临时设置(仅当前终端有效)
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌" export ANTHROPIC_BASE_URL="https://api.dakeai.cc"
2)Linux / macOS:永久设置(推荐)
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
✅ 四、启动 Claude Code(首次启动说明)
进入你的项目目录:
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 到最新版 |
✅ 六、进阶功能
1)接入外部工具(MCP:模型上下文协议)
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 工具可以访问你的系统/网络资源,务必只安装可信来源。
2)自定义团队快捷命令(项目共享)
在项目根目录创建:
./.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 中粘贴生产密钥、数据库密码、客户数据
- 使用第三方中转时,只用于学习/非敏感项目
✅ 八、实战案例:1 分钟生成扫雷小游戏(HTML + JS)
一条命令生成:
claude -p "用 HTML+JS 写一个扫雷小游戏,支持点击格子、右键标记地雷,带计时和重新开始按钮"
保存生成文件后运行(Python 示例):
python -m http.server 8000
浏览器访问:
http://localhost:8000
通常生成 + 运行速度非常快,成本视模型和输出长度而定。
✅ 总结(一句话版本)
Claude Code = 终端里的 Claude AI:写代码、重构、查文档、审查、测试一条龙;国内网络环境可通过官方或第三方中转接入使用。
到此这篇关于Claude Code 国内合规使用教程(2026年最新分享)的文章就介绍到这了,更多相关Claude Code 国内使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
相关文章

Claude Code 国内合规使用教程(2026年最新分享)
ClaudeCode是Anthropic官方的终端AI编程助手,本文详细介绍了安装准备、获取API令牌、配置环境变量、启动ClaudeCode等步骤,并提供了国内网络环境的使用方案与常见问题排查,2026-04-09
本文介绍了在Windows上安装并使用ClaudeCode(Anthropic开发的AI编程助手)的步骤,从安装Node.js、Git等依赖开始,到配置API Key、初次运行及常用命令,感兴趣的朋友一起看2026-04-09
手把手教你:在 IntelliJ IDEA 中集成并高效使用 Claude Code
文章介绍了ClaudeCode在Windows和macOS/Linux上的安装方法,推荐原生安装方式,同时提供了npm全局安装方式,但需Node.js支持,讲解了IDEA中的ClaudeCode插件安装和配置,包括插2026-04-08
从手动编码到AI协奏:Claude Code 高效进阶路线完全指南
这篇文章介绍了如何使用ClaudeCode这一AI编程工具,帮助开发者提高编程效率,内容分为青铜级、白银级和王者级三个阶段,分别介绍如何安装配置、定制使用、以及实现自动化开发2026-04-08






最新评论