Vibe Coding For AI 2: Claude CLI 安装与使用指南 • Hana's Blog

本文内容由 AI 生成，主要供博主自用参考，不保证完全准确，请以官方文档为准。

什么是 Claude CLI？#

Claude CLI（也叫 Claude Code）是 Anthropic 官方推出的命令行 AI 编程助手。和 IDE 插件不同，它直接运行在终端里，能够读取、修改你的代码文件，执行命令，甚至帮你管理 Git 工作流。对于习惯在终端工作的开发者来说，这是目前体验最好的 Coding Agent 之一。

本文面向 macOS 和 Linux 用户，带你从零开始安装并熟练使用 Claude CLI。

安装前准备#

安装 Node.js#

Claude CLI 通过 npm 分发，所以首先需要确保系统上有 Node.js（版本 >= 18）。

macOS（推荐用 Homebrew）：

brew install node

bash

Linux（Ubuntu/Debian）：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

bash

Linux（Arch）：

sudo pacman -S nodejs npm

bash

安装完成后验证：

node --version   # 应该 >= 18
npm --version

bash

检查网络环境#

Claude CLI 需要访问 Anthropic 的 API，国内用户需要确保终端走代理。可以用以下命令检查当前 IP：

curl ipin.io

bash

如果返回的是国内 IP，需要先配置好终端代理再继续。

安装 Claude CLI#

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

bash

安装完成后验证：

claude --version

bash

出现版本号即为安装成功。

配置 API Key#

获取 API Key#

前往 Anthropic Console ↗ 注册账号，进入 API Keys 页面创建一个新的密钥。

如果不想直接使用官方 API（价格较贵），也可以使用 Ikuncode ↗ 等中转服务，配置方式相同。

设置环境变量#

临时设置（当前终端会话有效）：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"

bash

永久设置（推荐）：

macOS/Linux 用户将以下内容添加到 ~/.zshrc 或 ~/.bashrc：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"

bash

然后重新加载配置：

source ~/.zshrc   # 或 source ~/.bashrc

bash

使用中转 API#

如果使用第三方中转服务，还需要额外设置 API 地址：

export ANTHROPIC_BASE_URL="https://你的中转地址/v1"

bash

启动 Claude CLI#

进入你的项目目录，直接运行：

cd /path/to/your/project
claude

bash

首次启动会进入一个交互式 TUI 界面，类似下图的对话框。你可以直接用自然语言描述你想做的事，Claude 会自动读取项目文件、执行命令、修改代码。

核心使用模式#

交互模式（默认）#

直接运行 claude 进入对话界面，这是最常用的模式。在这里你可以持续对话，Claude 会记住整个会话的上下文。

claude

bash

单次执行模式#

如果只想执行一个任务，不需要进入交互界面：

claude -p "帮我写一个读取 CSV 文件的 Python 函数"

bash

-p 是 --print 的缩写，执行完毕后直接退出，适合脚本集成。

管道模式#

Claude CLI 支持从标准输入读取内容，非常适合配合其他命令使用：

cat error.log | claude -p "分析这个错误日志，告诉我问题在哪里"

bash

git diff | claude -p "帮我写一个 commit message"

bash

常用斜杠命令#

在交互模式下，输入 / 可以触发内置命令。

会话管理#

命令	功能
`/help`	查看所有可用命令及说明
`/clear`	清空当前对话上下文，重新开始
`/compact [说明]`	压缩对话历史节省 token，可附加保留说明
`/cost`	查看当前会话的 token 消耗和费用估算
`/quit` 或 `/exit`	退出 Claude CLI

模型与配置#

命令	功能
`/model`	交互式切换当前使用的模型
`/doctor`	检查环境配置、API 连通性是否正常
`/init`	在当前项目生成 `CLAUDE.md` 配置文件
`/config`	查看或修改 Claude CLI 的配置项
`/vim`	切换到 Vim 键位模式（再次输入关闭）

记忆与上下文#

命令	功能
`/memory`	查看和管理跨会话的持久记忆内容
`/context`	查看当前上下文窗口的使用情况

代码与项目#

命令	功能
`/review`	对当前 git 改动进行代码审查
`/pr_comments`	拉取并展示当前 PR 的评论
`/bug`	快速进入 bug 报告模式，引导描述问题
`/terminal-setup`	配置终端 shell 集成（如 iTerm2 / zsh）

权限管理#

命令	功能
`/permissions`	查看当前会话的工具权限设置
`/allowed-tools`	列出当前允许自动执行的工具列表

自定义 Slash 命令#

除了内置命令，你还可以在 .claude/commands/ 目录下创建自定义命令。每个 .md 文件对应一个命令，文件名即命令名：

.claude/
└── commands/
    ├── deploy.md      # /deploy
    └── test-all.md    # /test-all

plaintext

文件内容就是发给 Claude 的 prompt 模板，支持 $ARGUMENTS 占位符接收参数：

# deploy.md
运行 `bun build` 构建项目，然后执行 `$ARGUMENTS` 部署到对应环境。
部署前先确认没有未提交的改动。

markdown

使用时：

/deploy production

plaintext

CLAUDE.md：项目级配置#

/init 命令会在项目根目录生成一个 CLAUDE.md 文件，这是 Claude 的”项目说明书”。你可以在里面写：

项目架构说明
常用命令（如何启动、测试、构建）
代码规范和约定
不希望 Claude 修改的文件或目录

每次启动 Claude CLI，它都会自动读取这个文件，从而更好地理解你的项目。

# CLAUDE.md 示例

## 项目说明
这是一个 FastAPI 后端项目，使用 PostgreSQL 数据库。

## 常用命令
- `uvicorn main:app --reload` - 启动开发服务器
- `pytest` - 运行测试
- `alembic upgrade head` - 执行数据库迁移

## 注意事项
- 不要修改 `migrations/` 目录下的文件
- 所有 API 接口需要添加类型注解

markdown

权限控制#

Claude CLI 在执行文件操作或运行命令时，默认会弹出确认提示。你可以通过以下方式调整权限策略：

自动允许所有操作（谨慎使用）：

claude --dangerously-skip-permissions

bash

只允许读取，不允许写入：

在对话中告诉 Claude “只读模式，不要修改任何文件” 即可，它会遵守这个约束。

针对特定工具设置权限：

在 CLAUDE.md 或项目的 .claude/settings.json 中可以精细控制哪些操作自动允许、哪些需要确认。

实用技巧#

多文件操作#

Claude CLI 可以同时处理多个文件，直接描述需求即可：

帮我把项目里所有的 console.log 替换成 logger.info，
并且确保 logger 已经在每个文件里正确导入

plaintext

结合 Git 工作流#

帮我查看最近 5 个 commit 的改动，
然后写一个总结性的 release note

plaintext

当前分支有哪些改动还没有提交？帮我整理成一个 commit

plaintext

代码审查#

帮我审查 src/auth.py 这个文件，
重点关注安全漏洞和性能问题

plaintext

调试辅助#

python main.py 2>&1 | claude -p "程序报错了，帮我分析原因并给出修复方案"

bash

常见问题#

Q: 提示 command not found: claude

检查 npm 全局安装路径是否在 PATH 里：

npm config get prefix
# 将输出的路径加上 /bin 添加到 PATH
export PATH="$(npm config get prefix)/bin:$PATH"

bash

Q: API 请求失败，提示 401

检查 ANTHROPIC_API_KEY 是否正确设置，可以用以下命令确认：

echo $ANTHROPIC_API_KEY

bash

Q: 响应很慢或超时

检查网络代理是否正常，确保终端流量走代理：

export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

bash

Q: 如何更新到最新版本

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

bash

小结#

Claude CLI 的核心优势在于它能直接操作你的代码库，而不只是给你看代码片段。配置好之后，日常的重构、调试、写测试、整理 commit 这些事情都可以交给它来做，你只需要用自然语言描述目标就好。

如果你之前用过 Cursor 或者 GitHub Copilot，Claude CLI 更像是一个能主动干活的同事，而不只是一个代码补全工具。上手之后，工作流会有质的变化。