首页 / Claude Code 接入
OFFICIAL · CLI · COMPATIBLE
Claude Code 完整接入指南 推荐
Anthropic 官方 CLI 工具,原生协议透传,体验与官方一致。本指南从 零基础 起步, 带你 10 个步骤 装好 Node.js、装好 Claude Code、配好平台 Key、跑通第一个项目,并掌握日常使用的核心技巧。
全程 10-15 分钟 零基础友好 Win / Mac / Linux 原生 API 协议
1装 Node.js 2装 Claude Code 3配置 Key 4启动 & 模型 5五种交互 6斜杠命令 7两种模式 8权限管理 9项目记忆 10问题排查
Claude Code 是什么? 它是 Anthropic 推出的 命令行编程助手。在你的项目目录里启动一次, Claude 就能直接 读代码、改文件、跑测试、调 Git、查日志,像一个坐在你旁边的高级工程师。 和网页版最大的区别是 —— 它能 动手,不只是聊。
1
安装 Node.js(运行环境)
难度 · 简单 ≈ 3 分钟
Claude Code 是用 Node.js 写的,所以第一步必须装好 Node.js(版本要 18 及以上)。 如果你已经装过,跑一下 node -v 看一下版本号,符合就跳到 Step 2。

方式 A · 官网安装(最简单,推荐新手)

  1. 打开 nodejs.org,下载 LTS 版本(写着 "推荐多数用户")的 .msi 安装包
  2. 双击安装包,一路 Next 即可(勾选 "Add to PATH",默认就勾着)
  3. 打开 PowerShell(开始菜单搜 PowerShell),验证
node -v        # 应该输出 v20.x.x 或以上
npm -v         # 应该输出 10.x 或以上

方式 B · 用 nvm-windows(适合需要多版本切换) 

# 1. 到 https://github.com/coreybutler/nvm-windows/releases 下载 nvm-setup.exe
# 2. 装好后在 PowerShell 中
nvm install 20
nvm use 20
node -v

方式 A · Homebrew(推荐) 

# 没装 brew 先装:https://brew.sh
brew install node
node -v

方式 B · nvm(多版本管理) 

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc
nvm install 20
nvm use 20

方式 C · 官网安装包:到 nodejs.org 下 .pkg,双击安装。

推荐用 nvm,避免系统包源里 Node 版本过老 

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
node -v

或者用系统包管理器(Ubuntu/Debian): 

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
验收标准:在终端跑 node -v 输出 v18.x 或更高就成功了。如果提示"找不到命令",说明 PATH 没生效,重启一下终端再试。
2
安装 Claude Code 命令行工具
难度 · 简单 ≈ 2 分钟
Node.js 装好后,用 npm 全局安装 Claude Code 即可。装完会有一个新命令 claude。 
# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装成功
claude --version

# 跑环境自检,网络/版本/配置一键体检
claude doctor
brew install anthropic/tap/claude-code
claude --version
claude doctor
Windows 注意:推荐使用 PowerShell 7 或 Windows Terminal,老的 cmd.exe 会出现渲染错位、中文乱码。 若你装了 nvm/fnm,确认 where.exe claude 指向的 Node 版本 ≥ 18。
以后想升级:claude update 或者 npm i -g @anthropic-ai/claude-code@latest。
3
配置环境变量(把请求指向本平台)
难度 · 中等 ≈ 3 分钟
通过 两个环境变量,把请求从 Anthropic 官方端点劫持到本平台代理。 你的密钥是平台后台分配的 sk-xxx,不是 Anthropic 官方 Key。

ANTHROPIC_BASE_URL

把请求地址改成 https://ai.sanren.pro,Claude Code 就会走本平台网关。

ANTHROPIC_AUTH_TOKEN

平台后台 / API Key 页面分配的 sk-xxx,用于鉴权。

# ── 当前会话立刻生效 ──
$env:ANTHROPIC_BASE_URL  = "https://ai.sanren.pro"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"

# ── 永久写入(下次开 shell 也生效)──
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL",  "https://ai.sanren.pro", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key",            "User")

# 验证
echo $env:ANTHROPIC_BASE_URL
# 写入 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_BASE_URL="https://ai.sanren.pro"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

# 立刻生效
source ~/.zshrc

# 验证
echo $ANTHROPIC_BASE_URL
三个常见坑
  1. 之前登录过 Anthropic 官方账号,本地缓存会 优先生效。先跑 claude logout,或删除 ~/.claude/.credentials.json。
  2. ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 是两个变量,平台用后者。同时设置可能冲突,先清掉 API_KEY。
  3. 改完变量后,已打开的 shell / Claude Code 都要重启,否则读不到新值。
4
启动 Claude Code & 选择模型
难度 · 简单 ≈ 1 分钟
关键:在你的项目目录里启动 Claude Code,这样它才能直接读到你的代码。 
cd ~/your-project    # 进入你的项目目录
claude                # 启动
首次启动会提示登录 —— 无需登录,环境变量已让它使用本平台账户。默认模型 claude-sonnet-4.6。

在交互中切换模型:

/model claude-sonnet-4.6   # 默认,速度快、便宜,日常首选
/model claude-opus-4.7     # 推理王者,复杂任务、长链条思考
/model claude-haiku-4.5    # 最轻量,简单批量任务

Sonnet 4.6 · 日常首选

读代码、改 bug、写测试、小重构、日常对话。性价比最高,90% 任务它都能完成。

Opus 4.7 · 推理王者

多文件大重构、系统设计、复杂调试、需要把多个上下文联起来推理的硬骨头。

5
五种核心交互方式(必须掌握)
难度 · 中等 日常 80% 用法
进入 Claude Code 后,在输入框里你能打这 五类东西。先把这五种背熟,日常 80% 操作就熟练了。
语法 用途 例子
自然语言 让它干活,中英文都行 把 src/api.ts 里 axios 换成 fetch
@文件路径 把文件加入上下文 @src/index.ts 这里为什么报错
!命令 直接跑 shell,不进对话 !git status
#内容 写入项目记忆 CLAUDE.md # 本项目用 pnpm,不要用 npm
/命令 斜杠命令(切模型、清上下文等) /model claude-opus-4.7
6
高频斜杠命令速查
日常常用
输入 /help 可看全部命令。下面是日常用得最多的一批,建议加书签。
命令作用
/model切换模型(sonnet / opus / haiku)
/clear清空当前会话上下文 —— 开新任务前必做
/compact自动总结历史,腾出上下文空间
/cost查看本轮 token 消耗 / 花费
/init扫一遍项目,自动生成 CLAUDE.md
/review让 Claude 评审当前分支的改动
/security-review安全视角评审当前改动
/config配置主题、默认模型、补全等
/doctor环境自检
/help查看全部命令
/exit退出
7
计划模式 vs 执行模式
Shift + Tab 切换
Claude Code 有两种工作模式,交互中按 Shift + Tab 切换。选对模式能省大量来回沟通。

执行模式(默认)

Claude 直接 Edit / Write / Bash,弹权限确认后即写文件、跑命令。

适合:明确的小任务、修 bug、加测试、跑脚本。

计划模式

Claude 先列方案,等你点头再动手,期间只读不写。

适合:大重构、跨多文件改动、不熟悉的项目第一次提需求。

8
权限管理 —— 告别频繁弹窗
难度 · 中等
默认情况下,Claude 跑命令、改文件都会弹确认框。把信任的命令加进白名单,后面就再也不弹。

配置文件位置(优先级从高到低)

./.claude/settings.json          # 项目级(团队共享,提交到 git)
./.claude/settings.local.json    # 本地覆盖(私人配置,不提交 git)
~/.claude/settings.json          # 全局(对所有项目生效)

示例:常用白名单 + 危险黑名单

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(pnpm test*)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Read(./**)",
      "Edit(./src/**)",
      "Write(./src/**)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force*)"
    ]
  }
}
偷懒做法:每次弹窗勾"始终允许此命令",白名单会自动追加。或者跑 /fewer-permission-prompts 让 Claude 扫历史自动生成。
9
项目记忆 —— CLAUDE.md
每轮自动加载
项目根目录的 CLAUDE.md 会 每轮自动加载 进上下文 —— Claude 一直记得你写的规则。 第一次进项目跑 /init,会自动扫代码生成一份,再手工调整。

推荐写入的内容

# 项目概述
- Next.js 14 + TypeScript 电商后台
- Prisma + PostgreSQL

# 命令
- 安装: pnpm install
- 开发: pnpm dev
- 测试: pnpm test:unit (不要用 npm test)
- 构建: pnpm build

# 风格约定
- 函数式组件 + TypeScript,不写 class
- 状态用 Zustand,不引 Redux
- HTTP 走 src/lib/request.ts,不直接 fetch

# 禁区
- components/legacy/ 历史代码,不要碰
- migrations/ 一律手写,不让 prisma 自动生成
10
常见问题排查 FAQ
遇到问题先查这里
返回 401 Unauthorized?
多半是 Token 没生效或被官方 OAuth 覆盖。先验证环境变量是否生效: 
echo $env:ANTHROPIC_AUTH_TOKEN     # Windows
echo $ANTHROPIC_AUTH_TOKEN          # macOS/Linux
claude logout                       # 清除官方 OAuth 凭据
请求还是发到 api.anthropic.com?
ANTHROPIC_BASE_URL 没生效。重启 shell 和 Claude Code 进程; Windows 上 $env: 设置只对当前会话有效,要永久生效请用 [Environment]::SetEnvironmentVariable。
中文乱码、终端显示错位?
换 Windows Terminal + PowerShell 7;或在 PowerShell 跑 chcp 65001 切到 UTF-8 编码。
对话太长,响应变慢/报上下文超限?
/compact 自动总结历史保留关键信息;或 /clear 彻底清空(开新任务推荐先 clear)。
想看完整请求日志(调试用)?
启动前打开 debug 日志: 
$env:ANTHROPIC_LOG = "debug"      # Windows
export ANTHROPIC_LOG="debug"      # macOS/Linux
claude
恭喜你,全部走完! 现在 Claude Code 已经能在本平台流畅工作。

三句话总结:
① 装好 Node.js 和 @anthropic-ai/claude-code,设两个环境变量,在项目目录里跑 claude。
② 把 @文件、!命令、#记忆、/命令 这四个快捷符号背熟,日常 80% 操作都靠它们。
③ 第一次进新项目先跑 /init 建 CLAUDE.md,把白名单和钩子配好,后面就一路顺风。