本页内容

Claude Code

本地运行 CLI 工具 并行任务

Anthropic 官方推出的命令行工具,在终端中直接使用 Claude 模型,理解整个代码库、生成新功能、修复 Bug、运行测试。

安装方式

原生安装脚本

无需预先安装 Node.js,脚本会自带独立运行环境。

curl -fsSL https://claude.ai/install.sh | bash

在 PowerShell 中执行:

irm https://claude.ai/install.ps1 | iex

安装完成后运行 claude 启动,首次启动会引导登录。

系统要求

操作系统

macOS 10.15+ · Ubuntu 20.04+ / Debian 10+ · Windows 10+(原生或通过 WSL)

软件依赖

Node.js 18 或更高版本、npm 或 yarn(原生安装脚本方式可跳过此依赖)

内存

建议 4GB 以上可用内存,处理大型代码库时更顺畅

终端

支持 UTF-8 的现代终端,如 Terminal、iTerm2、Windows Terminal

环境变量配置

Claude Code 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 两个环境变量指向 API 地址与密钥。统一使用中转地址 https://ai.kedang.net,将下方的 <你的 API Key> 替换为实际密钥。

临时配置(仅当前会话)

关闭终端后失效,适合临时测试。

macOS / Linux

export ANTHROPIC_BASE_URL="https://ai.kedang.net"
export ANTHROPIC_API_KEY="<你的 API Key>"

Windows(PowerShell)

$env:ANTHROPIC_BASE_URL="https://ai.kedang.net"
$env:ANTHROPIC_API_KEY="<你的 API Key>"

永久配置

写入 Shell 配置文件或系统环境变量,新开终端后自动生效。

macOS / Linux

方法 2:手动编辑配置文件

在 ~/.zshrc 或 ~/.bashrc 末尾追加:

export ANTHROPIC_BASE_URL="https://ai.kedang.net"
export ANTHROPIC_API_KEY="<你的 API Key>"

保存后执行 source ~/.zshrc(按实际文件替换)使其立即生效。

Windows

方法 2:下载配置模板

下载 settings.json 模板,替换 API Key 后放入 %USERPROFILE%\.claude\ 目录。

开始使用

claude

进入当前目录,启动交互式会话

claude --help

查看所有可用命令与参数

claude --version

查看当前安装版本

claude upgrade

升级到最新版本

故障排除

!

提示找不到 claude 命令

确认 npm 全局 bin 目录已加入 PATH,可运行 npm config get prefix 查看安装路径。

!

API Key 无效或未设置

检查环境变量是否生效:echo $ANTHROPIC_API_KEY,修改 shell 配置后需要重新打开终端或执行 source。

!

Windows 下无法运行

建议通过 WSL 安装使用,原生 Windows 终端对部分交互特性支持有限。

官方地址