Claude Code¶

项目介绍

Unleash Claude’s raw power directly in your terminal. Search million-line codebases instantly. Turn hours-long workflows into a single command. Your tools. Your workflow. Your codebase, evolving at thought speed.

直接在你的终端中，释放 Claude 的强大威力。瞬间搜索百万行代码库。将数小时的工作流化为一条命令。你的工具。你的工作流。你的代码库，以思维速度进化。

官方主页：https://www.anthropic.com/claude-code
安装方法：见本页下方教程

效果演示¶

特性¶

功能分类	特性
代码理解	- 深度代码库分析，利用智能代理搜索理解项目结构和依赖
	- 自动生成高层次代码概述，快速帮助用户理解代码库
代码编辑	- 支持多文件协同编辑，适用于复杂代码修改
	- 提供符合项目模式和架构的实际可用代码建议
集成能力	- 支持在终端中直接运行，无需切换上下文
	- 与VS Code和JetBrains IDE无缝集成，无需复制粘贴
代码生成和优化	- 自动生成代码、创建测试、修复错误，支持从概念到提交的完整流程
	- 为代码生成和理解优化，结合Claude Opus 4等先进模型
安全与灵活性	- 改动需获得用户明确授权，文件和命令操作更安全
	- 适应用户代码规范，支持自定义配置
工具链整合	- 支持与GitHub、GitLab等工具结合，实现自动化工作流程
	- 与测试套件、构建系统集成，增强现有开发工具
跨平台与扩展	- 支持Windows、macOS、Linux操作系统
	- 可配置运行在SDK或GitHub Actions中，灵活适配不同需求
主要应用场景	- 代码库入门和理解、新成员快速上手
	- 代码问题修复与优化流程，从分析问题到提交PR
	- 项目代码重构与新功能实现
用户反馈亮点	- 提升日常开发效率，省去例行任务消耗的时间
	- 处理复杂多步骤任务表现优异，扩展开发可能性

AI 模型配置方法¶

参数修改¶

Api Key：前往 Anthropic 官网，或者ZetaTechs API获取。

请求地址格式：

第三方（示例）

https://api.zetatechs.com

Windows 端图文指引¶

1.安装 Node.js 环境¶

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

Node.js 环境安装步骤

打开浏览器访问 https://nodejs.org/
点击 "LTS" 版本进行下载（推荐长期支持版本）
下载完成后双击 .msi 文件
按照安装向导完成安装，保持默认设置即可

Windows 注意事项

建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

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

2.安装 Git Bash¶

Windows 注意事项

Windows 环境下需要使用 Git Bash 安装 Claude code。安装完成后，环境变量设置和使用 Claude Code 仍然在普通的 PowerShell 或 CMD 中进行。

下载并安装 Git for Windows

访问 https://git-scm.com/downloads/win
点击 "Download for Windows" 下载安装包
运行下载的 .exe 安装文件
在安装过程中保持默认设置，直接点击 "Next" 完成安装

验证 Git Bash 安装

安装完成后，打开 Git Bash，输入以下命令验证：

git --version

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

3.安装 Claude Code¶

安装 Claude Code

打开 Git Bash（重要：不要使用 PowerShell），运行以下命令：

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

重要提醒

必须在 Git Bash 中运行，不要在 PowerShell 中运行
如果遇到权限问题，可以尝试在 Git Bash 中使用 sudo 命令

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

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

4.设置环境变量¶

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置多个环境变量。

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置多个环境变量：

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

变量名： ANTHROPIC_AUTH_TOKEN
变量值： sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

ANTHROPIC_AUTH_TOKEN：前往ZetaTechs API获取。

注意：变量名为可选项，使用 Claude 官方模型无需修改，其他兼容模型修改示例：

变量名： ANTHROPIC_MODEL
变量值： claude-sonnet-4-20250514-flatfee

ANTHROPIC_MODEL可选模型：claude-sonnet-4-20250514-flatfee、gemini-2.5-pro、gpt-4.1等其他兼容模型。注：-flatfee 后缀表示按次收费

变量名： ANTHROPIC_SMALL_FAST_MODEL
变量值： claude-3-5-haiku-20241022

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

在 PowerShell 中验证：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_MODEL
echo $env:ANTHROPIC_SMALL_FAST_MODEL

在 CMD 中验证：

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_MODEL%
echo %ANTHROPIC_SMALL_FAST_MODEL%

预期输出示例：

https://api.zetatechs.com
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
claude-sonnet-4-20250514-flatfee
claude-3-5-haiku-20241022

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。

5.开始使用 Claude Code¶

现在你可以开始使用 Claude Code 了！

启动 Claude Code

直接启动 Claude Code:

# 启动 Claude Code
claude

在特定项目中使用:

# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Claude Code
claude

选择模型

输入命令：

/model

Enter进入，选择官方模型选择 1、2，使用自定义模型选择3.claude-sonnet-4-20250514-flatfee

或直接输入命令设置模型：

/model claude-sonnet-4-20250514-flatfee

注：-flatfee 后缀表示按次收费

注意：设置环境变量修改ANTHROPIC_BASE_URL后，使用所有模型（包括官方预设模型）均调用自定义接入点，而不使用官方账号额度。

临时修改模型方法:
/model claude-sonnet-4-20250514-flatfee

6.Windows 常见问题解决¶

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

以管理员身份运行PowerShell
或者配置npm使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

设置永久环境变量后需要：

重新启动PowerShell或CMD
或者注销并重新登录Windows
验证设置：echo $env:ANTHROPIC_BASE_URL

MacOS 端图文指引¶

1.安装 Homebrew (已安装请跳过)¶

Homebrew 是 macOS（或 Linux）缺失的软件包的管理器。

官网：https://brew.sh

安装 Homebrew

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

2.安装 Node.js 环境¶

Node.js 环境安装步骤

更新 Homebrew

brew update

安装 Node.js

brew install node

macOS 注意事项

如果遇到权限问题，可能需要使用sudo
首次运行可能需要在系统偏好设置中允许
建议使用Terminal或iTerm2

验证安装是否成功

安装完成后，打开终端，输入以下命令：

node --version
npm --version

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

3.安装 Claude Code¶

安装 Claude Code

打开终端，运行以下命令：

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

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

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

4.设置环境变量¶

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

修改环境变量 | zsh (默认)

输入命令：

echo 'export ANTHROPIC_BASE_URL="https://api.zetatechs.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.zshrc

ANTHROPIC_AUTH_TOKEN：前往ZetaTechs API获取。

可选项：

echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514-flatfee"' >> ~/.zshrc
echo 'export ANTHROPIC_SMALL_FAST_MODEL="claude-3-5-haiku-20241022"' >> ~/.zshrc

ANTHROPIC_MODEL可选模型：claude-sonnet-4-20250514-flatfee、gemini-2.5-pro、gpt-4.1等其他兼容模型。注：-flatfee 后缀表示按次收费应用修改：

source ~/.zshrc

修改环境变量 | bash

输入命令：

echo 'export ANTHROPIC_BASE_URL="https://api.zetatechs.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bash_profile

可选项：

echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514-flatfee"' >> ~/.bash_profile
echo 'export ANTHROPIC_SMALL_FAST_MODEL="claude-3-5-haiku-20241022"' >> ~/.bash_profile

ANTHROPIC_MODEL可选模型：claude-sonnet-4-20250514-flatfee、gemini-2.5-pro、gpt-4.1等其他兼容模型。注：-flatfee 后缀表示按次收费应用修改：

source ~/.bash_profile

5.开始使用 Claude Code¶

现在你可以开始使用 Claude Code 了！

启动 Claude Code

直接启动 Claude Code:

# 启动 Claude Code
claude

在特定项目中使用:

# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

选择模型

输入命令：

/model

Enter进入，选择官方模型选择 1、2，使用自定义模型选择3.claude-sonnet-4-20250514-flatfee

或直接输入命令设置模型：

/model claude-sonnet-4-20250514-flatfee

注：-flatfee 后缀表示按次收费

注意：设置环境变量修改ANTHROPIC_BASE_URL后，使用所有模型（包括官方预设模型）均调用自定义接入点，而不使用官方账号额度。

临时修改模型方法:
/model claude-sonnet-4-20250514-flatfee

6.macOS 常见问题解决¶

安装时提示权限错误

尝试以下解决方法：

使用sudo安装：sudo npm install -g @anthropic-ai/claude-code
或者配置npm使用用户目录：npm config set prefix ~/.npm-global

macOS 安全设置阻止运行

如果系统阻止运行 Claude Code：

打开"系统偏好设置" → "安全性与隐私"
点击"仍要打开"或"允许"
或者在Terminal中运行：sudo spctl --master-disable

环境变量不生效

检查以下几点：

确认修改了正确的配置文件（.zshrc或.bash_profile）
重新启动Terminal
验证设置：echo $ANTHROPIC_BASE_URL

Linux 端图文指引¶

1.安装 Node.js 环境¶

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

Node.js 环境安装步骤

添加 NodeSource 仓库

sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

安装 Node.js

sudo apt-get install -y nodejs

Linux 注意事项

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

验证安装是否成功

安装完成后，打开终端，输入以下命令：

node --version
npm --version

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

2.安装 Claude Code¶

安装 Claude Code

打开终端，运行以下命令：

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

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

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

3.设置环境变量¶

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

修改环境变量 | bash (默认)

输入命令：

echo 'export ANTHROPIC_BASE_URL="https://api.zetatechs.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc

ANTHROPIC_AUTH_TOKEN：前往ZetaTechs API获取。

可选项：

echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514-flatfee"' >> ~/.bashrc
echo 'export ANTHROPIC_SMALL_FAST_MODEL="claude-3-5-haiku-20241022"' >> ~/.bashrc

ANTHROPIC_MODEL可选模型：claude-sonnet-4-20250514-flatfee、gemini-2.5-pro、gpt-4.1等其他兼容模型。注：-flatfee 后缀表示按次收费应用修改：

source ~/.bashrc

修改环境变量 | zsh

输入命令：

echo 'export ANTHROPIC_BASE_URL="https://api.zetatechs.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.zshrc

可选项：

echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514-flatfee"' >> ~/.zshrc
echo 'export ANTHROPIC_SMALL_FAST_MODEL="claude-3-5-haiku-20241022"' >> ~/.zshrc

ANTHROPIC_MODEL可选模型：claude-sonnet-4-20250514-flatfee、gemini-2.5-pro、gpt-4.1等其他兼容模型。注：-flatfee 后缀表示按次收费应用修改：

source ~/.zshrc

4.开始使用 Claude Code¶

现在你可以开始使用 Claude Code 了！

启动 Claude Code

直接启动 Claude Code:

# 启动 Claude Code
claude

在特定项目中使用:

# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

选择模型

输入命令：

/model

Enter进入，选择官方模型选择 1、2，使用自定义模型选择3.claude-sonnet-4-20250514-flatfee

或直接输入命令设置模型：

/model claude-sonnet-4-20250514-flatfee

ANTHROPIC_MODEL可选模型：claude-sonnet-4-20250514-flatfee、gemini-2.5-pro、gpt-4.1等其他兼容模型。注：-flatfee 后缀表示按次收费

注意：设置环境变量修改ANTHROPIC_BASE_URL后，使用所有模型（包括官方预设模型）均调用自定义接入点，而不使用官方账号额度。

临时修改模型方法:
/model claude-sonnet-4-20250514-flatfee
ANTHROPIC_MODEL可选模型：claude-sonnet-4-20250514-flatfee、gemini-2.5-pro、gpt-4.1等其他兼容模型。注：-flatfee 后缀表示按次收费

5.Linux 常见问题解决¶

安装时提示权限错误

尝试以下解决方法：

使用sudo安装：sudo npm install -g @anthropic-ai/claude-code
或者配置npm使用用户目录：npm config set prefix ~/.npm-global
然后添加到PATH：export PATH=~/.npm-global/bin:$PATH

缺少依赖库

某些 Linux 发行版需要安装额外依赖：

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

环境变量不生效

检查以下几点：

确认修改了正确的配置文件（.bashrc或.zshrc）
重新启动终端或运行source ~/.bashrc
验证设置：echo $ANTHROPIC_BASE_URL