Claude Code¶
Claude Code 是 Anthropic 提供的终端编程工具,可以在项目目录中协助阅读代码、修改文件和运行命令。Windows 和 Linux 都可以通过 npm 安装。
安装¶
请先完成 npm 环境配置。当前 Claude Code 的 npm 包要求 Node.js 22 或更高版本,建议直接安装 Node.js LTS。
Windows(PowerShell)¶
npm install -g @anthropic-ai/claude-code
可用镜像站:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
Linux(Ubuntu / Debian,Bash)¶
npm install -g @anthropic-ai/claude-code
Linux 全局安装权限
若命令提示 EACCES 或权限不足,在 npm 全局安装或更新命令前加 sudo,例如 sudo npm install -g @anthropic-ai/claude-code。
验证安装¶
claude --version
claude doctor
如果系统提示找不到 claude 命令,请关闭并重新打开终端,使新的 PATH 配置生效。
首次登录¶
进入代码项目目录后启动 Claude Code:
cd your-project
claude
首次启动时按照浏览器提示完成登录。可用的登录方式和账户要求以 Claude Code 当前官方说明为准。
也可以使用 API key。下面的设置只对当前终端会话生效:
$env:ANTHROPIC_API_KEY = "你的 Anthropic API Key"
claude
export ANTHROPIC_API_KEY='你的 Anthropic API Key'
claude
其他 api 接入¶
Claude Code 支持接入 DeepSeek 等提供 Anthropic 兼容 API 的服务。以下以 DeepSeek V4.1 Flash 的 API 写法为例,修改 $HOME/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的 DeepSeek API Key",
"ANTHROPIC_MODEL": "deepseek-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}
$HOME 表示当前用户的主目录:Linux 中通常为 /home/<用户名>;PowerShell 中通常为 C:\Users\<用户名>。修改完成后重新启动 Claude Code,使配置生效。
更新¶
使用 npm 安装时,可以执行:
npm install -g @anthropic-ai/claude-code@latest
使用镜像站更新:
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com
Windows PowerShell 和 Linux Bash 使用相同的 npm 命令。