Claude Code 配置教程

Claude Code 是 Anthropic 官方的 AI 编程助手命令行工具，可以读取、分析、修改整个项目代码。

跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。

第一步：安装 Node.js 环境

Claude Code 需要 Node.js 18+ 环境才能运行。

WindowsmacOSLinux / WSL2

bash

# 方法一：官网下载安装包（推荐）
# 访问 https://nodejs.org/ 下载 LTS 版本，双击安装即可

# 方法二：使用 winget
winget install OpenJS.NodeJS.LTS

# 方法三：使用 Chocolatey
choco install nodejs-lts

bash

# 方法一：官网下载安装包（推荐）
# 访问 https://nodejs.org/ 下载 LTS 版本

# 方法二：使用 Homebrew（推荐）
brew install node

# 方法三：使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

bash

# 方法一：使用 NodeSource 仓库（推荐）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 方法二：使用系统包管理器
# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

Linux 注意事项

某些发行版可能需要安装额外的依赖
如果遇到权限问题，使用 sudo
确保你的用户在 npm 的全局目录有写权限

验证安装

bash

node --version
npm --version

如果显示版本号，说明安装成功！

第二步：安装 Claude Code

WindowsmacOSLinux / WSL2

bash

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

bash

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 如果遇到权限问题
sudo npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

bash

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 如果遇到权限问题，使用 sudo
sudo npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

如果显示版本号，恭喜！Claude Code 已经成功安装。

第三步：设置环境变量

为了让 Claude Code 连接到 ClaudeHub 服务，需要设置两个环境变量：

变量名	值
`ANTHROPIC_BASE_URL`	`https://api.qinzhiai.com`
`ANTHROPIC_AUTH_TOKEN`	`sk-你的API密钥`（获取教程）

Windows 配置

图形界面配置（推荐新手）

打开环境变量设置
- 按 Win + S 搜索"环境变量"
点击"环境变量"按钮
添加 ANTHROPIC_BASE_URL
- 在用户环境变量中点击"新建"
- 设置变量：
  - 变量名：ANTHROPIC_BASE_URL
  - 变量值：https://api.qinzhiai.com
添加 ANTHROPIC_AUTH_TOKEN
- 再次点击"新建"
- 设置变量：
  - 变量名：ANTHROPIC_AUTH_TOKEN
  - 变量值：sk-xxxx（你的 API 令牌）
确认设置
- 点击确定保存所有设置

提示

设置环境变量后需要重启终端才能生效。

PowerShell 命令行配置

powershell

# 临时设置（当前会话有效）
$env:ANTHROPIC_BASE_URL = "https://api.qinzhiai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的API密钥"

# 永久设置（推荐）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.qinzhiai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的API密钥", "User")

macOS 配置

bash

# 临时设置（当前会话有效）
export ANTHROPIC_BASE_URL="https://api.qinzhiai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"

# 永久设置 - 添加到 shell 配置文件
# 对于 zsh（macOS 默认）
echo 'export ANTHROPIC_BASE_URL="https://api.qinzhiai.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://api.qinzhiai.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

Linux / WSL2 配置

bash

# 临时设置（当前会话有效）
export ANTHROPIC_BASE_URL="https://api.qinzhiai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"

# 永久设置 - 添加到 shell 配置文件
# 对于 bash（默认）
echo 'export ANTHROPIC_BASE_URL="https://api.qinzhiai.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.bashrc
source ~/.bashrc

# 对于 zsh
echo 'export ANTHROPIC_BASE_URL="https://api.qinzhiai.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc

记得替换 API 密钥

将 sk-你的API密钥 替换为你在获取 API Key 中创建的实际密钥。

方式二：配置文件（可选）

除了环境变量，也可以使用配置文件：

项目级配置：在项目根目录创建 .claude/settings.json

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.qinzhiai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的APIKey",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929"
  }
}

全局配置：

Windows: C:\Users\你的用户名\.claude\settings.json
macOS/Linux: ~/.claude/settings.json

第四步：首次运行

启动 Claude Code

bash

# 在项目目录启动
cd your-project
claude

初始化设置

首次运行会引导您完成设置：

选择配色方案 选择喜欢的界面主题（Dark/Light/System）
确认安全须知 阅读并确认代码执行权限
信任工作目录 确认允许 Claude Code 访问当前目录
配置成功 看到此界面表示配置完成
开始对话 现在可以开始使用了！

用途	推荐模型	推荐分组
日常编程	`claude-sonnet-4-5-20250929`	`Claude_code`
复杂任务	`claude-opus-4-20250514`	`Claude_code_1`
快速响应	`claude-haiku-4-5-20251001`	`Claude_code`

键盘快捷键

基本操作

快捷键	功能
`Ctrl+C`	取消当前输入或生成
`Ctrl+D`	退出 Claude Code
`Ctrl+L`	清屏
`↑/↓`	浏览历史命令
`Esc+Esc`	编辑上一条消息

多行输入

快捷键	功能
`\` + `Enter`	换行（所有终端）
`Option+Enter`	换行（macOS）

斜杠命令

命令	功能
`/help`	显示帮助信息
`/clear`	清除对话历史
`/compact`	压缩上下文
`/model`	切换 AI 模型
`/cost`	查看使用成本
`/config`	查看/修改配置
`/review`	请求代码审查

最佳实践

1. 创建 CLAUDE.md 文件

在项目根目录创建 CLAUDE.md 文件，帮助 Claude 理解项目：

markdown

# 项目说明

这是一个 React + TypeScript 项目，使用：
- React 18
- TypeScript 5
- Tailwind CSS

## 开发规范
- 使用函数组件
- 遵循 ESLint 规则

2. 使用文件引用

使用 @ 引用文件：

解释 @src/utils/auth.ts 中的验证逻辑

3. 管理上下文

当上下文接近满时：

/clear：清空对话历史
/compact：压缩上下文，保留关键信息

4. 自定义命令

在 .claude/commands/ 目录添加自定义命令：

markdown

<!-- .claude/commands/test.md -->
Run all tests and show coverage report.

!npm test -- --coverage

使用：/test

常见问题

提示"无法连接到 API"

检查以下几点：

API Key 是否正确
网络是否正常
API 地址是否为 https://api.qinzhiai.com

验证环境变量：

WindowsmacOS / Linux

powershell

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

bash

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

可以使用其他模型吗？

Claude Code 仅支持 Claude 系列模型：

claude- 开头的模型
cc- 开头的模型
cld- 开头的模型

如何查看消费？

登录控制台 → 日志 → 使用日志，每条请求都有详细计费。

Claude Code 配置教程

第一步：安装 Node.js 环境

第二步：安装 Claude Code

第三步：设置环境变量

Windows 配置

图形界面配置（推荐新手）

PowerShell 命令行配置

macOS 配置

Linux / WSL2 配置

方式二：配置文件（可选）

第四步：首次运行

启动 Claude Code

初始化设置

推荐模型和分组

键盘快捷键

基本操作

多行输入

斜杠命令

最佳实践

1. 创建 CLAUDE.md 文件

2. 使用文件引用

3. 管理上下文

4. 自定义命令

常见问题

提示"无法连接到 API"

可以使用其他模型吗？

如何查看消费？

更多资源

Claude Code 配置教程 ​

第一步：安装 Node.js 环境 ​

第二步：安装 Claude Code ​

第三步：设置环境变量 ​

Windows 配置 ​

图形界面配置（推荐新手） ​

PowerShell 命令行配置 ​

macOS 配置 ​

Linux / WSL2 配置 ​

方式二：配置文件（可选） ​

第四步：首次运行 ​

启动 Claude Code ​

初始化设置 ​

推荐模型和分组 ​

键盘快捷键 ​

基本操作 ​

多行输入 ​

斜杠命令 ​

最佳实践 ​

1. 创建 CLAUDE.md 文件 ​

2. 使用文件引用 ​

3. 管理上下文 ​

4. 自定义命令 ​

常见问题 ​

提示"无法连接到 API" ​

可以使用其他模型吗？ ​

如何查看消费？ ​

更多资源 ​

Claude Code 配置教程

第一步：安装 Node.js 环境

第二步：安装 Claude Code

第三步：设置环境变量

Windows 配置

图形界面配置（推荐新手）

PowerShell 命令行配置

macOS 配置

Linux / WSL2 配置

方式二：配置文件（可选）

第四步：首次运行

启动 Claude Code

初始化设置

推荐模型和分组

键盘快捷键

基本操作

多行输入

斜杠命令

最佳实践

1. 创建 CLAUDE.md 文件

2. 使用文件引用

3. 管理上下文

4. 自定义命令

常见问题

提示"无法连接到 API"

可以使用其他模型吗？

如何查看消费？

更多资源