四、Claude Code 使用指南（本地部署）

一、Windows · Claude Code 配置说明

1

打开 Cmd（命令行）

快速呼出快捷键：Win+R，输入 cmd 回车。

1. 安装 Claude Code CLI

1

验证 Node.js 环境

在执行 npm install -g @anthropic-ai/claude-code 之前，必须先验证这两个命令能正常输出版本号：

# 1. 验证 Node.js
node -v
# 正常输出：v20.x.x（或更高版本）

# 2. 验证 npm
npm -v
# 正常输出：10.x.x（或更高版本）

如果这两个命令报错，说明 Node.js 安装 / 环境变量配置有问题，必须先解决，再装 Claude Code。

winget install OpenJS.NodeJS.LTS

winget install OpenJS.NodeJS

node -v
npm -v

node -v
npm -v

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

2. 配置系统环境变量

5

设置 Windows 系统环境变量

菜单搜索"编辑系统环境变量"，弹出系统属性窗口，选择「系统环境变量」。每次新建变量之前，先完整检查用户变量和系统变量中是否已经有这个变量名了，若有请先删除，然后再新建。

需要设置以下两个环境变量值：

变量名：ANTHROPIC_BASE_URL，变量值：https://ai.yunsuguan.com

变量名：ANTHROPIC_AUTH_TOKEN，变量值：你的密钥

6

启动 Claude Code

配置完成后新建 Cmd 窗口输入 claude 指令一直回车进入对话界面。

切换模型指令：/model

二、macOS / Linux · Claude Code 配置说明

macOS 10.15+ 系统 或 Linux 系统，并且已安装 Node.js。

如未安装 Node.js，可以点击以下链接下载安装：https://nodejs.cn/download/

方法 A：brew 安装（最简单、推荐）

brew install node

方法 B：官方脚本一键安装（无 brew 也能用）

curl -fsSL https://deb.nodesource.com/setup_current.x | sudo -E bash -
sudo apt-get install -y nodejs

验证：

node -v
npm -v

使用 Cmd+Space 搜索 "Terminal" 或在 应用程序/实用工具 中启动终端。

安装 Claude Code

在终端中输入代码，安装官方源版本：

npm install -g @anthropic-ai/claude

若执行时提示权限报错，在命令前加 sudo 即可：
sudo npm install -g @anthropic-ai/claude

1. 配置环境变量 — Linux

API_KEY="你的密钥"

echo "export ANTHROPIC_BASE_URL=https://ai.yunsuguan.com/v1" >> ~/.bashrc
echo "export ANTHROPIC_AUTH_TOKEN=$你在我们服务器生成的秘钥/key" >> ~/.bashrc
echo "export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1" >> ~/.zshrc

source ~/.bashrc

2. 配置环境变量 — macOS

API_KEY="你的密钥"

echo "export ANTHROPIC_BASE_URL=https://ai.yunsuguan.com" >> ~/.zshrc
echo "export ANTHROPIC_AUTH_TOKEN=$你在我们服务器生成的秘钥/key" >> ~/.zshrc
echo "export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1" >> ~/.zshrc

source ~/.zshrc

命令名为 claude，通过终端输入 claude + 回车调出使用。

3. 修改密钥代码

临时生效

直接重新赋值新的 key（把 new_your_key_here 替换成你的新密钥）：

export ANTHROPIC_AUTH_TOKEN=new_your_key_here

验证是否修改成功：

echo $ANTHROPIC_AUTH_TOKEN

永久生效

先删除旧的密钥配置：

sed -i '' '/ANTHROPIC_AUTH_TOKEN=/d' ~/.zshrc

写入新的密钥（把 new_your_key_here 替换成你的新密钥）：

echo "export ANTHROPIC_AUTH_TOKEN=new_your_key_here" >> ~/.zshrc

立即加载配置，让新密钥生效：

source ~/.zshrc

验证是否修改成功：

echo $ANTHROPIC_AUTH_TOKEN

sed -i '' '/ANTHROPIC_AUTH_TOKEN=/d' ~/.zshrc
echo "export ANTHROPIC_AUTH_TOKEN=sk-88888888888888888888" >> ~/.zshrc
source ~/.zshrc

若遇 npm install -g 权限被拒场景，输入：
sudo npm install -g @anthropic-ai/claude-code
执行完之后，输入你的电脑密码（输入时不会显示，直接输完按回车即可）。

4. Claude Code 命令大全

本文档基于 Anthropic 官方最新文档整理，覆盖会话内斜杠命令、CLI 全局命令、VS Code 插件专属命令、终端交互快捷键四大类，标注废弃命令与使用别名，适配 v2.1.92+ 版本。

4.1 会话内核心斜杠命令（/ 开头，REPL 交互模式通用）

输入 / 即可唤起自动补全，<> 为必填参数，[] 为可选参数。

1. 对话与会话管理

2. 模型与配置管理

3. 代码与开发效率（核心高频）

4. 工具与集成管理

5. 诊断、用量与账号管理

6. 其他实用命令

4.2 CLI 全局命令（终端直接执行，非会话内）

2. 账号与管理命令

3. 高频启动标志（启动会话时附加）