命令行工具安装
在终端中安装和配置 Claude Code CLI
概述
Claude Code 命令行工具允许开发者在终端中使用 Claude Code 功能,适合:
- 终端爱好者
- CI/CD 流水线集成
- 自动化脚本编写
- 远程服务器(无 GUI 环境)
安装
npm(推荐)
npm install -g @anthropic-ai/claude-codeyarn
yarn global add @anthropic-ai/claude-codepnpm
pnpm add -g @anthropic-ai/claude-code验证安装
claude --version
# 或
claude -v初始配置
登录账户
claude login执行后会打开浏览器进行授权,登录成功后自动完成配置。
配置默认模型
# 使用 Opus 4
claude config set model claude-4-opus
# 使用 Sonnet 4
claude config set model claude-4-sonnet查看配置
# 查看所有配置
claude config list
# 查看特定配置项
claude config get model基本命令
帮助
# 查看所有命令
claude help
# 查看特定命令帮助
claude help chat交互式聊天
claude chat代码生成
claude code "write a Python function to calculate Fibonacci numbers"代码解释
claude explain "def fib(n): return 1 if n <= 1 else fib(n-1) + fib(n-2)"高级配置
输出格式
# JSON 格式
claude config set output-format json
# 文本格式(默认)
claude config set output-format text超时时间
claude config set timeout 60代理设置
# 设置代理
claude config set proxy http://proxy.example.com:8080
# 取消代理
claude config unset proxy常见问题
命令未找到
问题:claude 命令显示 "command not found"
解决方案:
- 确认已正确安装
- 检查 npm 全局路径是否在环境变量中
- macOS/Linux:在
~/.bashrc或~/.zshrc添加export PATH="$HOME/.npm/bin:$PATH" - Windows:确保
%USERPROFILE%\AppData\Roaming\npm在系统 PATH 中
登录失败
问题:浏览器打开但无法完成登录
解决方案:
- 检查网络连接
- 确认账户凭据正确
- 检查浏览器是否阻止弹窗
- 尝试清除浏览器缓存
API 请求失败
问题:显示 "API request failed"
解决方案:
- 检查网络连接
- 确认已登录账户
- 检查模型配置是否正确
- 尝试增加超时时间
更新
# npm
npm update -g @anthropic-ai/claude-code
# yarn
yarn global upgrade @anthropic-ai/claude-code
# pnpm
pnpm update -g @anthropic-ai/claude-code卸载
# npm
npm uninstall -g @anthropic-ai/claude-code
# yarn
yarn global remove @anthropic-ai/claude-code
# pnpm
pnpm remove -g @anthropic-ai/claude-code