命令行工具安装

在终端中安装和配置 Claude Code CLI

概述

Claude Code 命令行工具允许开发者在终端中使用 Claude Code 功能,适合:

  • 终端爱好者
  • CI/CD 流水线集成
  • 自动化脚本编写
  • 远程服务器(无 GUI 环境)

安装

npm(推荐)

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

yarn

yarn global add @anthropic-ai/claude-code

pnpm

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

On this page