什么是Claude Code

Claude Code现代开发者的 AI 编程助手，让代码开发变得简单高效

实际开发体验对比

主要功能

• 智能代码生成：快速生成高质量代码

• 代码分析：深度理解和分析代码结构

• 调试助手：智能发现和修复代码问题

• 文档生成：自动生成代码文档

• 命令行集成：无缝集成到开发流程

支持平台

• Windows

支持 Windows 10/11

• macOS

支持macOS 10.15+

• Linux

支持主流Linux发行版

系统要求

安装步骤

详细的分平台安装指南

Windows 版本教程

系统要求

• Windows 10 或 Windows 11

• Node.js 18+

• 网络连接

1. 安装 Node.js

访问 https://nodejs.cn/download/current，进入 Node.JS 官网，点击最新版本，选择对应的操作系统和版本下载即可

下载后双击安装，之后一直点击下一步。安装完成后，打开 CMD 窗口，执行命令验证安装：

node -v

2. 安装 Claude Code

打开命令提示符 (CMD) 或 PowerShell，运行：

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

3. 验证安装

claude --version

4. 配置 API

4.1 获取 Auth Token

访问 https://code.zxin.de/console/token 进行以下操作：

• 点击控制台 → API 令牌页面

• 点击「添加令牌」

• 令牌分组请选择：Claude Code专用（务必选择此分组，否则无法使用）

• 令牌名称：随意填写

• 额度建议：设置为无限额度

• 其他选项保持默认

4.2 配置环境变量

重要提示：请将下方的 sk-xxx 替换为您在 https://code.zxin.de/console/token 生成的Claude Code专用 API 密钥！

方法一：图形化配置（推荐，永久生效）

1. 右键点击 "此电脑" → 选择 "属性"

2. 点击 "高级系统设置"

3. 在 "系统属性" 窗口中点击 "环境变量"

4. ⭐ 重要：在 "系统变量" 部分点击 "新建"（多人共享电脑可选择 "用户变量"）

添加以下两个变量：

    • 变量名：ANTHROPIC_AUTH_TOKEN，变量值：您的API密钥

    • 变量名：ANTHROPIC_BASE_URL，变量值：https://code.zxin.de

1. 点击 "确定" 保存

方法二：PowerShell（永久设置）

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://code.zxin.de", "User")

方法三：命令提示符（永久设置）

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://code.zxin.de"

注意： 永久设置后需要重启终端才能生效。推荐使用永久配置方式。

5. 启动 Claude Code

配置完成后，先进入到工程目录：

cd your-project-folder

然后，运行以下命令启动：

claude

首次启动后需要先进行主题的选择等操作：

• 选择喜欢的主题（回车）

• 确认安全须知（回车）

• 使用默认 Terminal 配置（回车）

• 信任工作目录（回车）

• 开始编程！🚀

Mac 版本教程

系统要求

• macOS 10.15 (Catalina) 或更高版本

• Node.js 18+

• 网络连接

1. 安装 Homebrew (推荐)

如果尚未安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js

使用 Homebrew：

brew install node

或从 Node.js 官网 下载安装包。

3. 安装 Claude Code

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

4. 验证安装

claude --version

5. 配置 API

5.1 获取 Auth Token

访问 https://code.zxin.de/console/token 进行以下操作：

• 点击控制台 → API 令牌页面

• 点击「添加令牌」

• 令牌分组请选择：Claude Code专用（务必选择此分组，否则无法使用）

• 令牌名称：随意填写

• 额度建议：设置为无限额度

• 其他选项保持默认

5.2 配置环境变量

重要提示：请将下方的 sk-xxx 替换为您在 https://code.zxin.de/console/token 生成的Claude Code专用 API 密钥！

方法一：使用 Bash（推荐）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://code.zxin.de"' >> ~/.bash_profile
source ~/.bash_profile

方法二：使用 Zsh（如果使用 Oh My Zsh）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://code.zxin.de"' >> ~/.zshrc
source ~/.zshrc

注意： 永久设置后需要重启终端才能生效。

6. 启动 Claude Code

配置完成后，先进入到工程目录：

cd your-project-folder

claude

首次启动后需要先进行主题的选择等操作：

• 选择喜欢的主题（回车）

• 确认安全须知（回车）

• 使用默认 Terminal 配置（回车）

• 信任工作目录（回车）

• 开始编程！🚀

Linux 版本教程

系统要求

• Linux 发行版 (Ubuntu 18.04+, CentOS 7+, Debian 9+)

• Node.js 18+

• 网络连接

1. 安装 Node.js

Ubuntu/Debian

更新包列表：

sudo apt update

安装 Node.js：

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

CentOS/RHEL/Fedora

使用 dnf (Fedora) 或 yum (CentOS/RHEL)：

sudo dnf install nodejs npm
# 或者
sudo yum install nodejs npm

Arch Linux

sudo pacman -S nodejs npm

2. 安装 Claude Code

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

3. 验证安装

claude --version

4. 配置 API

4.1 获取 Auth Token

访问 https://code.zxin.de/console/token 进行以下操作：

• 点击控制台 → API 令牌页面

• 点击「添加令牌」

• 令牌分组请选择：Claude Code专用（务必选择此分组，否则无法使用）

• 令牌名称：随意填写

• 额度建议：设置为无限额度

• 其他选项保持默认

4.2 配置环境变量

重要提示：请将下方的 sk-xxx 替换为您在 https://code.zxin.de/console/token 生成的Claude Code专用 API 密钥！

方法一：Ubuntu/Debian （Bash）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://code.zxin.de"' >> ~/.bashrc
source ~/.bashrc

方法二：Fedora/CentOS （Zsh 用户）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://code.zxin.de"' >> ~/.zshrc
source ~/.zshrc

注意： 永久设置后需要重启终端或执行 source 命令才能生效。

5. 启动 Claude Code

配置完成后，先进入到工程目录：

cd your-project-folder

运行以下命令启动：

claude

首次启动后需要先进行主题的选择等操作：

• 选择喜欢的主题（回车）

• 确认安全须知（回车）

• 使用默认 Terminal 配置（回车）

• 信任工作目录（回车）

• 开始编程！🚀

settings.json 配置

另一种永久配置方法

配置位置

• Mac: ~/.claude/settings.json 或 .claude/settings.json

• Windows: %USERPROFILE%\.claude\settings.json

• Linux: ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴为Claude Code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://code.zxin.de",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

环境变量说明

ANTHROPIC_AUTH_TOKEN

您在 Sany API 控制台 获取的 API 密钥

ANTHROPIC_BASE_URL

Sany API 服务地址

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

禁用非必要流量

推荐使用 settings.json 配置文件方式，更加安全且便于管理。环境变量适合临时测试使用。

配置说明

CLAUDE.md 项目记忆文件

在项目根目录创建 CLAUDE.md 文件来存储项目架构、编码标准和工作流程指导

# Claude Code 项目配置

## 项目架构
- Next.js 15 + App Router
- TypeScript + Tailwind CSS
- shadcn/ui 组件库

## 编码标准
- 使用 2 空格缩进
- 优先使用函数式组件
- 使用 TypeScript 严格模式

## 工作流程
- 提交前运行 lint 和 typecheck
- 遵循 conventional commits 规范

Claude Code 官方文档

查看完整的 Claude Code 使用指南和 API 参考文档，了解更多高级功能和最佳实践。

访问官方文档

常见命令参考

基础命令

交互模式命令

内置斜杠命令

常见问题

Invalid API Key · Please run /login 怎么解决？

这表明 Claude Code 没有检测到环境变量。不要使用 /login 命令，只需参考上面的安装配置部分正确设置环境变量或 settings.json 文件即可。

显示 offline 是什么原因？

Claude Code 会通过检查是否能连接到 Google 来判断网络状态。显示 offline 并不影响正常使用，只是表明无法访问 Google（可能是网络环境限制）。

为什么浏览网页的 Fetch 会失败？

这是因为 Claude Code 在访问网页前会调用 Claude 官方服务来判断网页是否可访问。建议检查网络连接，必要时使用稳定的国际网络环境。

如何退出 Claude Code？

按两次 Ctrl-C 或者两次 Ctrl-D 即可退出。

如何更新 Claude Code？

一行命令搞定：claude update

出现 529、549 报错怎么解决？

这是上游服务器负载过高导致的临时错误。建议：
• 稍等几分钟后重试
• 尝试切换到 Sonnet 模型（使用 /model 命令）
• 如持续出现可联系技术支持

API Error: Cannot read properties of undefined (reading 'filter') 报错？

这是网络连接不稳定导致的临时错误。建议：
• 检查网络连接稳定性
• 重新启动 Claude Code
• 如问题持续，可联系技术支持获取帮助

推荐使用哪个模型？

推荐使用 Sonnet 模型：
• 性价比最高：比 Opus 便宜约 5 倍
• 性能优秀：智能程度与 Opus 基本相同
• 切换方法：在 Claude Code 中输入 /model 命令选择