Claude Code
Anthropic 官方推出的命令行工具,在终端中直接使用 Claude 模型,理解整个代码库、生成新功能、修复 Bug、运行测试。
安装方式
通过 npm 安装
全局安装 CLI,适用于已安装 Node.js 的环境。
npm install -g @anthropic-ai/claude-code
原生安装脚本
无需预先安装 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
方法 1:一键配置脚本
自动检测 Shell 类型,写入配置文件并备份旧配置。
bash <(curl -Ls https://ai.kedang.net/doc/start.sh)
运行后按提示输入 API Key 即可,脚本会自动写入 ~/.zshrc / ~/.bashrc 等配置文件。
方法 2:手动编辑配置文件
在 ~/.zshrc 或 ~/.bashrc 末尾追加:
export ANTHROPIC_BASE_URL="https://ai.kedang.net" export ANTHROPIC_API_KEY="<你的 API Key>"
保存后执行 source ~/.zshrc(按实际文件替换)使其立即生效。
Windows
方法 1:系统环境变量
「系统属性」→「环境变量」→「用户变量」中新建:
保存后需要重新打开终端 / PowerShell 窗口才会生效。
开始使用
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 终端对部分交互特性支持有限。