AI精品店

Appearance

Claude Code CLI 集成 ​

Claude Code CLI 是 Anthropic 官方的终端编程助手，直接在命令行里对话、写代码。它是三种客户端里配置最简单的一种，而且 VSCode 插件会复用它的 ~/.claude 配置——先把 CLI 跑通，插件就能直接使用。

这一页的目标：你的终端里能跑通 node / npm / claude 三个命令。

1. 检查 Node.js / npm ​

Claude Code CLI 依赖 Node.js 18+，建议用 20 LTS。打开终端运行：

bash
node --version
npm --version

如果命令报"找不到命令"或版本过低，先完成下一步安装；已经装好的直接跳到第 3 步。

2. 安装 Node.js（按你的系统选一种） ​

powershell
# 方法一：官方安装包（推荐新手）
# 打开 https://nodejs.org/ 下载 LTS（Node.js 20 LTS），安装时保持默认选项，勾选 "Add to PATH"

# 方法二：命令行（推荐 Windows 11 / 新系统）
winget install OpenJS.NodeJS.LTS

# 习惯包管理器也可以用：
choco install nodejs-lts
# 或
scoop install nodejs-lts
bash
# 推荐 Homebrew：
brew install node@20

# 装完后如果 node 仍找不到，按 Homebrew 的提示把路径加入 shell 配置
bash
# 系统仓库版本偏旧时，建议用 NodeSource：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

3. 安装 Claude Code CLI ​

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

显示版本号即安装成功。

国内网络下安装慢，可临时指定 npm 镜像：

bash
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

4. 首次运行（生成配置目录） ​

bash
claude

首次运行通常会创建 ~/.claude/ 目录（Windows 在 C:\Users\你的用户名\.claude）。后续配置中转站会用到这个目录。

5. 配置接入 ccodezh ​

选一种配置方式完成接入：

6. 启动使用 ​

进入任意项目目录，运行：

bash
claude

能进入对话界面并正常回复，即接入成功。

7. 更新 Claude Code（可选） ​

bash
claude update

常见安装问题 ​

npm 全局安装提示权限不足（permission denied） ​

  • Windows：用管理员打开 PowerShell 再重试，或配置 npm 全局目录到用户目录
  • macOS / Linux：建议使用 nvm 管理 Node.js，避免全局权限问题

遇到问题？

  1. 先查 中转站运行状态，排除服务端问题
  2. 仍有报错，看 错误排查指南