适用 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 -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）

提示：第三方中转服务并非官方，优点是国内更容易直连、可能有试用额度；缺点是安全、稳定性、隐私都取决于服务商。

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

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：第三方中转地址（如果用官方则通常不需要设置）

---

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：写代码、重构、查文档、审查、测试一条龙；国内网络环境可通过官方或第三方中转接入使用。

---

✅ 你原文相比这版的关键提升点（你发布时更像“专业教程”）

• 补齐了 Windows 环境变量设置
• “国内免费”写得更稳妥：强调第三方风险，避免“保证永久免费”这种容易被打脸的描述
• 排版更适合公众号/博客（每段可直接复制）
• 多了 验证命令、常见错误排查、安全建议，减少读者踩坑
• 语言更中立、少广告感，更容易被转发和长期留存

---

如果你愿意，我还能继续帮你做两件事（不用你再写内容）：

1. 把这篇教程改成 更适合公众号排版（含标题层级、提示框、表情符号风格统一）
2. 给你附一份 “新手从 0 到跑通 Claude Code 的最短路径版（3 分钟版）”，适合放在开头作为 TL;DR。