适用Windows / macOS / Linux，并包含国内网络环境可用方案与常见问题排查。
Claude Code 是 Anthropic 官方的终端 AI 编程助手，可用于：写代码、解释代码、重构、生成脚本、审查 PR、运行测试、维护项目记忆（CLAUDE.md）等。
✅ 一、安装准备
1）安装 Node.js（推荐 ≥ 18，建议用 LTS）
Claude Code 依赖 Node.js。推荐安装 Node.js LTS 版本。
Ubuntu / Debian
curl-fsSL https://deb.nodesource.com/setup_lts.x|sudo-Ebash-sudoapt-getinstall-y nodejsnode-vnpm-vmacOS（Homebrew）
brewinstallnodenode-vnpm-vWindows（推荐）
- 到 Node.js 官网下载安装LTS
- 安装后在 PowerShell / CMD 执行：
node-v npm-v2）安装 Claude Code（全局安装）
npminstall-g @anthropic-ai/claude-code claude --version如果看到类似v0.3.2的版本号，说明安装成功。
如果你用的是 macOS/Linux 且权限报错，可尝试：
sudonpminstall-g @anthropic-ai/claude-code或使用nvm管理 Node 避免 sudo（更推荐）。
✅ 二、获取 API 令牌（国内网络环境可用方案）
方案 A（官方方式）：Anthropic API Key
如果你可以正常访问 Anthropic 官方并能付款，这是最稳妥的方式。
方案 B（国内常用）：第三方中转服务（示例：DKAPI）
提示：第三方中转服务并非官方，优点是国内更容易直连、可能有试用额度；缺点是安全、稳定性、隐私都取决于服务商。
基本步骤（通用，不强绑定某一家）
- 注册并登录中转平台
- 在控制台创建 API Token（一般以
sk-开头） - 记录 Token 与 Base URL（通常平台会提供类似
https://xxx.xxx的地址）
✅ 三、配置环境变量（强烈推荐写入配置文件）
Claude Code 通过环境变量读取 Token 与 API 地址：
ANTHROPIC_AUTH_TOKEN：你的 API Key / TokenANTHROPIC_BASE_URL：第三方中转地址（如果用官方则通常不需要设置）
1）Linux / macOS：临时设置（仅当前终端有效）
exportANTHROPIC_AUTH_TOKEN="sk-你的令牌"exportANTHROPIC_BASE_URL="https://api.dakeai.cc"2）Linux / macOS：永久设置（推荐）
bash 用户
echo'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"'>>~/.bashrcecho'export ANTHROPIC_BASE_URL="https://api.dakeai.cc"'>>~/.bashrcsource~/.bashrczsh 用户（macOS 默认）
echo'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"'>>~/.zshrcecho'export ANTHROPIC_BASE_URL="https://api.dakeai.cc"'>>~/.zshrcsource~/.zshrc3）Windows：永久设置（推荐）
PowerShell（当前用户）
setx ANTHROPIC_AUTH_TOKEN"sk-你的令牌"setx ANTHROPIC_BASE_URL"https://api.dakeai.cc"设置后请重新打开一个新的 PowerShell / 终端窗口再运行 Claude Code。
验证是否生效：
echo$env:ANTHROPIC_AUTH_TOKENecho$env:ANTHROPIC_BASE_URL✅ 四、启动 Claude Code（首次启动说明）
进入你的项目目录：
cdyour-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 mcpaddmysql npx @benborla29/mcp-server-mysql\-eMYSQL_HOST=localhost\-eMYSQL_USER=root\-eMYSQL_PASS=你的密码\-eMYSQL_DB=test添加 Playwright（网页自动化）
claude mcpaddplaywright 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.server8000浏览器访问：
http://localhost:8000
通常生成 + 运行速度非常快，成本视模型和输出长度而定。
✅ 总结（一句话版本）
Claude Code = 终端里的 Claude AI：写代码、重构、查文档、审查、测试一条龙；国内网络环境可通过官方或第三方中转接入使用。
✅ 你原文相比这版的关键提升点（你发布时更像“专业教程”）
- 补齐了Windows 环境变量设置
- “国内免费”写得更稳妥：强调第三方风险，避免“保证永久免费”这种容易被打脸的描述
- 排版更适合公众号/博客（每段可直接复制）
- 多了验证命令、常见错误排查、安全建议，减少读者踩坑
- 语言更中立、少广告感，更容易被转发和长期留存
如果你愿意，我还能继续帮你做两件事（不用你再写内容）：
- 把这篇教程改成更适合公众号排版（含标题层级、提示框、表情符号风格统一）
- 给你附一份“新手从 0 到跑通 Claude Code 的最短路径版（3 分钟版）”，适合放在开头作为 TL;DR。
