Claude Code 配置教程

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

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

第一步：安装 Node.js 环境

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

WindowsmacOSLinux / WSL2

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

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

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

# 方法一：官网下载安装包（推荐）
# 访问 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

# 方法一：使用 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

WARNING

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

验证安装

node --version
npm --version

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

第二步：安装 Claude Code

WindowsmacOSLinux / WSL2

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

# 验证安装
claude --version

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

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

# 验证安装
claude --version

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

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

# 验证安装
claude --version

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

第三步：设置环境变量

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

变量名	值
`ANTHROPIC_BASE_URL`	`https://api.flymux.com`
`ANTHROPIC_AUTH_TOKEN`	`sk-你的API密钥`

Windows 配置

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

打开环境变量设置

按 Win + S 搜索"环境变量"

点击"环境变量"按钮

添加 ANTHROPIC_BASE_URL

在用户环境变量中点击"新建"

设置变量：

变量名：ANTHROPIC_BASE_URL
变量值：https://api.flymux.com

添加 ANTHROPIC_AUTH_TOKEN

再次点击"新建"
设置变量：
变量名：ANTHROPIC_AUTH_TOKEN
变量值：sk-xxxx（你的 API 令牌）

确认设置

点击确定保存所有设置

TIP

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

PowerShell 命令行配置

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

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

macOS 配置

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

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

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

Linux / WSL2 配置

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

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

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

TIP

将 sk-你的API密钥 替换为你在控制台创建的实际密钥。

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

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

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.flymux.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

WARNING

如果使用项目级配置，请将 .claude/settings.json 添加到 .gitignore，避免将 API Key 提交到版本控制。

全局配置：

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

第四步：首次运行

启动 Claude Code

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

初始化设置

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

选择配色方案选择喜欢的界面主题（Dark/Light/System）

确认安全须知阅读并确认代码执行权限

信任工作目录确认允许 Claude Code 访问当前目录

配置成功看到此界面表示配置完成

开始对话现在可以开始使用了！

用途	推荐模型	推荐分组
日常编程	`claude-sonnet-4-6`	`Claude_code`
复杂任务	`claude-opus-4-7`	`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 理解项目：

# 项目说明

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

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

2. 使用文件引用

使用 @ 引用文件：

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

3. 管理上下文

当上下文接近满时：

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

4. 自定义命令

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

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

!npm test -- --coverage

使用：/test

常见问题

提示"无法连接到 API"

检查以下几点：

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

验证环境变量：

WindowsmacOS / Linux

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

可以使用其他模型吗？

Claude Code 仅支持 Claude 系列模型：

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

如何查看消费？

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

进阶常见问题

如何在 VSCode 中使用

先在 VSCode 扩展商店中安装 Claude 插件。若你已经通过 CC-Switch 或手动方式配置过 Claude Code CLI，通常不需要二次配置，因为插件会读取同一套环境变量。

如果需要在 VSCode 中单独指定环境变量，可在 settings.json 中加入：

json

{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "你的API密钥"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.flymux.com"
    }
  ]
}

配置完成后重启 VSCode。

如何节省 Claude Code 使用成本

Claude 的计费通常包含输入、输出、缓存创建和缓存读取。Claude Code 会在请求中携带历史上下文，上下文越长，后续请求的输入和缓存费用越高。

建议：

在缓存有效期内连续处理同一个问题，减少重复创建缓存
一个会话只解决一组相关问题，完成后及时新开会话
上下文过长时使用 /compact 压缩，但重要细节最好先写入 CLAUDE.md
避免让一个长会话同时处理多个无关模块

Claude Code 配置教程

第一步：安装 Node.js 环境

第二步：安装 Claude Code

第三步：设置环境变量

Windows 配置

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

PowerShell 命令行配置

macOS 配置

Linux / WSL2 配置

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

第四步：首次运行

启动 Claude Code

初始化设置

推荐模型和分组

键盘快捷键

基本操作

多行输入

斜杠命令

最佳实践

1. 创建 CLAUDE.md 文件

2. 使用文件引用

3. 管理上下文

4. 自定义命令

常见问题

提示"无法连接到 API"

可以使用其他模型吗？

如何查看消费？

更多资源

进阶常见问题

如何在 VSCode 中使用

如何节省 Claude Code 使用成本

Claude Code 配置教程

第一步：安装 Node.js 环境

第二步：安装 Claude Code

第三步：设置环境变量

Windows 配置

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

PowerShell 命令行配置

macOS 配置

Linux / WSL2 配置

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

第四步：首次运行

启动 Claude Code

初始化设置

推荐模型和分组

键盘快捷键

基本操作

多行输入

斜杠命令

最佳实践

1. 创建 CLAUDE.md 文件

2. 使用文件引用

3. 管理上下文

4. 自定义命令

常见问题

提示"无法连接到 API"

可以使用其他模型吗？

如何查看消费？

更多资源

进阶常见问题 ​

如何在 VSCode 中使用 ​

如何节省 Claude Code 使用成本 ​

进阶常见问题

如何在 VSCode 中使用

如何节省 Claude Code 使用成本