ClaudeCode教程(3)-命令行工具安装

命令行工具安装

概述

Claude Code提供了命令行工具，允许开发者在终端或命令提示符中使用Claude Code的功能。命令行工具特别适合那些更喜欢使用终端进行开发的开发者，或者需要在CI/CD流水线中集成Claude Code的场景。

安装命令行工具

使用npm安装（推荐）

Claude Code的命令行工具可以通过npm全局安装：

1
npm install -g claude-code

使用yarn安装

如果你使用yarn作为包管理器，可以使用以下命令安装：

1
yarn global add claude-code

使用pnpm安装

如果你使用pnpm作为包管理器，可以使用以下命令安装：

1
pnpm add -g claude-code

验证安装

安装完成后，可以通过以下命令验证Claude Code命令行工具是否已正确安装：

1
2
3
4
5
# 检查Claude Code版本
claude --version

# 或使用缩写
cl --version

配置命令行工具

安装完成后，需要进行一些基本配置才能使用Claude Code命令行工具。

登录Claude账户

在使用命令行工具之前，需要先登录Claude账户：

1
2
3
4
# 登录Claude账户
claude login
# 或使用缩写
cl login

执行上述命令后，会打开默认浏览器，跳转到Claude Code的登录页面。输入你的Claude账户凭据进行登录，登录成功后，浏览器会显示”授权成功”的提示，命令行工具会自动完成授权。

[!help]
如果第一安装运行此命令会默认打开浏览器进行认证，由于A畜对国内用户不太友好，下一章节会讲述如何通过代理等形式跳过认证环节使用国内大模型厂商

配置默认模型

可以通过以下命令配置默认使用的Claude模型：

1
2
3
4
5
# 配置默认模型为Opus 4
claude config set model claude-4-opus

# 或配置为Sonnet 4
claude config set model claude-4-sonnet

查看配置

可以通过以下命令查看当前的配置：

1
2
3
4
# 查看所有配置
claude config list
# 查看特定配置项
claude config get model

基本命令使用

帮助命令

可以使用以下命令查看Claude Code命令行工具的帮助信息：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 查看所有命令
claude help

# 查看特定命令的帮助
claude help chat

### 2.3.5.2 聊天命令

可以使用`chat`命令与Claude Code进行对话：

# 启动交互式聊天
claude chat
# 或使用缩写
cl chat

代码生成命令

可以使用code命令生成代码：

1
2
# 生成一个简单的Python函数
claude code "write a Python function to calculate Fibonacci numbers"

代码解释命令

可以使用explain命令解释代码：

1
2
# 解释一个Python函数
claude explain "def fib(n): return 1 if n <= 1 else fib(n-1) + fib(n-2)"

代码执行命令

可以使用run命令执行生成的代码：

1
2
# 执行一个Python函数
claude run "def fib(n): return 1 if n <= 1 else fib(n-1) + fib(n-2)"

命令行工具的高级配置

配置输出格式

可以配置命令行工具的输出格式：

1
2
3
4
5
6
7
8
9
10
11
12
# 配置输出格式为JSON
claude config set output-format json

# 配置输出格式为文本（默认）
claude config set output-format text

### 2.3.6.2 配置超时时间

可以配置命令行工具的超时时间：

# 配置超时时间为60秒
claude config set timeout 60

配置代理

如果你的网络环境需要使用代理，可以配置命令行工具的代理：

1
2
3
4
5
# 配置HTTP代理
claude config set proxy http://proxy.example.com:8080

# 取消代理配置
claude config unset proxy

常见问题与解决方案

命令未找到

问题：运行claude命令时显示”command not found”

解决方案：

  • 确保已正确安装Claude Code命令行工具
  • 检查npm全局安装路径是否已添加到系统环境变量中
  • 对于macOS和Linux，可以将以下行添加到~/.bashrc或~/.zshrc文件中： bash export PATH=”$HOME/.npm/bin:$PATH”
    • 对于Windows，确保%USERPROFILE%\AppData\Roaming\npm已添加到系统环境变量中

登录失败

问题：执行claude login命令后，浏览器打开但无法登录

解决方案：

  • 检查网络连接
  • 确保你使用的是正确的Claude账户凭据
  • 检查浏览器是否阻止了弹出窗口
  • 尝试清除浏览器缓存和Cookie
  • 尝试使用不同的浏览器进行授权

命令执行失败

问题：执行Claude Code命令时显示”API request failed”

解决方案：

  • 检查网络连接
  • 确保已正确登录Claude账户
  • 检查配置的模型是否可用
  • 尝试增加超时时间
  • 检查是否有防火墙或代理设置阻止了API请求

命令行工具更新

可以通过以下命令更新Claude Code命令行工具：

1
2
3
4
5
6
# 使用npm更新
npm update -g claude-code
# 使用yarn更新
yarn global upgrade claude-code
# 使用pnpm更新
pnpm update -g claude-code

卸载命令行工具

如果需要卸载Claude Code命令行工具，可以使用以下命令：

1
2
3
4
5
6
7
8
# 使用npm卸载
npm uninstall -g claude-code

# 使用yarn卸载
yarn global remove claude-code

# 使用pnpm卸载
pnpm remove -g claude-code
#ClaudeCode
ClaudeCode教程(3)-命令行工具安装
https://github.com/yangxiangnanwill/yangxiangnanwill.github.io/2026/01/05/好好码代码吖/AI/ClaudeCode教程(3)-命令行工具安装/
作者
will
发布于
2026年1月5日
许可协议