Claude Code 接入教程

Claude Code 是 Anthropic 推出的现代开发者 AI 编程助手，直接在终端中运行，能够理解整个代码库并通过自然语言命令帮助你更快地编码。

前置条件

1. 前往 RabbitCloud 控制台 注册并获取 API Key
2. 安装 Node.js 18+
3. Windows 用户 必须先安装 Git for Windows（见下方）
4. 4GB+ 可用内存 + 稳定网络

支持平台

Windows / macOS / Linux

Windows 用户：安装 Git for Windows（必须）

⚠️ 跳过此步会导致 Claude Code 无法在 Windows 上运行！

国内镜像（推荐，速度快）： 👉 Git-2.47.1-64-bit.exe（npmmirror 镜像）

官方地址（备用）： 👉 https://git-scm.com/downloads/win

下载后运行安装程序，保持所有默认选项点击 Next 安装即可。安装完成后重启 PowerShell 继续。

1. 安装 Claude Code CLI（原版官方包）

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

⚠️ 必须安装原版 @anthropic-ai/claude-code，勿使用第三方替代包。

2. API 配置

方式一：一键配置（推荐）

安装好 CLI 后直接运行：

npx rabbitcloud-api

按照提示输入 API Key 即可自动完成所有配置。

方式二：手动配置

编辑 ~/.claude/settings.json（Windows: C:\Users\你的用户名\.claude\settings.json）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_BASE_URL": "https://rabbitcloud.club",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}

方式三：环境变量

Linux / macOS:

export ANTHROPIC_BASE_URL="https://rabbitcloud.club"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL="https://rabbitcloud.club"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的Key"

跳过首次引导（必须）

在 ~/.claude.json 中写入，避免因网络问题卡在引导页：

{
  "hasCompletedOnboarding": true
}

3. 启动与基础使用

cd your-project
claude

启动后即可通过自然语言对话：

> 帮我分析这个项目的架构
> 给 UserService 添加一个分页查询方法
> 修复 login 接口的参数校验问题

4. 常用命令

• /compact : 压缩对话历史，释放 context token
• /model : 切换模型
• /resume : 恢复上一次的对话（也可以使用 claude --resume 启动）
• /clear : 清空当前对话历史

5. 高级技巧

项目记忆文件 (CLAUDE.md)

在项目根目录创建 CLAUDE.md，Claude 每次启动自动读取：

# 项目架构
- 前端：React + TypeScript + Tailwind
- 后端：Node.js + Express + Prisma

# 编码标准
- 使用 ESLint + Prettier
- API 响应统一使用 { code, data, message } 格式

MCP 配置 (.mcp.json)

在项目根目录创建 .mcp.json 连接外部工具：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/project"
      ]
    }
  }
}

VS Code / Cursor / Trae 插件集成

💡 CLI 配置完成后，再安装编辑器插件即可直接使用，无需重复填写 API Key。

• VS Code： 在扩展商店搜索 Claude Code（Anthropic 发布），安装后插件自动读取本地 CLI 配置。
• Cursor / Trae： 参见对应教程，插件同样依赖本地 CLI。

👉 VS Code 插件教程 | Cursor 教程

使用心得

1. 先让 Claude 分析项目结构，再提具体需求
2. 复杂任务拆分小步骤
3. 善用 CLAUDE.md 提供项目上下文
4. 定期 /compact 避免 token 溢出
5. 对生成的代码做 review，不要盲目接受

---

💡 提示: 如果遇到问题，请先查看 常见问题 文档。如果依然无法解决，请携带完整报错截图前往首页，公告内添加客服联系方式，添加客服询问解决。