以下是 Claude Code 的完整使用教程（2025年7月最新版），适用于 Windows / macOS / Linux，并特别说明 国内用户如何免费使用：

✅ 一、安装准备

1. 安装 Node.js（≥18.0）

# Ubuntu / Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

sudo apt-get install -y nodejs

# macOS brew install node

2. 安装 Claude Code（全局）

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

验证成功会输出版本号，如 v0.3.2。

✅ 二、获取 API 令牌（国内用户推荐）

方法：使用 AnyRouter 免费中转服务，步骤操作

1 打开 https://anyrouter.top/register?aff=wu6V

2 用 GitHub 登录，免费领取 $100 额度

3 进入“API 令牌”页面，点击“添加令牌”

4 获取以 sk- 开头的令牌，设为无限额度

✅ 三、配置环境变量（推荐写入文件）

临时设置（仅当前终端有效）：

export ANTHROPIC_AUTH_TOKEN=sk-你的令牌 export ANTHROPIC_BASE_URL=https://anyrouter.top

永久设置（推荐）：

# bash 用户 echo -e '\nexport ANTHROPIC_AUTH_TOKEN=sk-你的令牌' >> ~/.bashrc echo -e '\nexport ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bashrc # zsh 用户 echo -e '\nexport ANTHROPIC_AUTH_TOKEN=sk-你的令牌' >> ~/.zshrc echo -e '\nexport ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.zshrc # 重载配置 source ~/.bashrc

✅ 四、启动 Claude Code

cd your-project-folder claude

首次启动需完成以下设置： - 选择主题 - 确认安全须知 - 使用默认 Terminal 配置 - 信任当前工作目录

✅ 五、常用命令一览

命令说明claude启动交互式会话claude -p "生成一个登录页面"一次性查询claude --continue恢复上次对话/clear清空会话/cost查看 token 使用/memory编辑项目记忆文件（CLAUDE.md）/review请求代码审查/config查看或修改配置claude update更新 Claude Code 到最新版本✅ 六、进阶功能

1. 接入外部工具（MCP）

# 添加 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'

2. 自定义命令（团队共享）

在项目根目录下创建 .claude/commands.json，定义快捷命令，如：

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

✅ 七、国内使用注意事项

问题解决方法API 报错退出重试或更换代理显示 offline不影响正常使用，继续即可fetch failed确保全局代理已开启，或切换网络✅ 八、实战案例：1分钟生成扫雷小游戏

claude -p "用 HTML+JS 写一个扫雷小游戏，支持点击格子、右键标记地雷"

生成后运行：

python -m http.server 8000 # 浏览器访问 http://localhost:8000

实测生成 + 运行耗时 < 1分钟，消耗约 $0.2。

✅ 总结一句话

Claude Code = 终端里的 Claude AI，写代码、查文档、重构、测试一条龙，国内也能免费用！