如何使用 Claude Code CLI:安装、Anthropic 登录、仓库首个编码任务
安装 claude、完成 Anthropic 登录,在 git 仓库跑第一个可 git diff 验证的小编码任务。
要在终端用 Claude Code CLI 跑第一个仓库任务,先完成四步:按官方方式安装 claude、完成 Anthropic 登录(订阅或 Console)、在 git 仓库根启动会话,再审阅后批准首个小改动。
对照 docs.anthropic.com/en/docs/claude-code/overview 与 docs.anthropic.com/en/docs/claude-code/quickstart。检索词 Claude Code CLI 安装、Claude Code 登录。这是 Anthropic Claude Code 产品,不是本站会议工具。短会见 sitdraw,步骤见 如何创建与加入房间。
订阅登录与 API 密钥各走哪条路
浏览器登录
首次运行 claude 时按提示在浏览器完成 Claude Pro/Max/Team/Enterprise 或 Claude Console 认证;会话内输入 /login 可切换账号或重新登录。
ANTHROPIC_API_KEY
若已设置环境变量 ANTHROPIC_API_KEY,Claude Code 会询问是否使用该密钥;你确认后可能跳过浏览器登录。勿把密钥提交进 git 或贴进聊天。
| 目标 | 入口 | 第一次怎么验收 |
|---|---|---|
| 安装 | curl -fsSL https://claude.ai/install.sh | bash、Homebrew、WinGet | 新终端里 claude --version 打印版本号 |
| 登录 | 首次 claude 或 /login | 提示符出现,可问只读问题 |
| 了解仓库 | 「what does this project do?」等自然语言 | Claude 读取相关文件后给出摘要 |
| 首个改动 | 单文件小任务(README 一行、注释) | 批准 diff 后本地 git diff 核对 |
安装、登录、第一个编码任务
- 01安装 Claude Code CLI
macOS/Linux/WSL 推荐
curl -fsSL https://claude.ai/install.sh | bash(原生安装会自动后台更新)。也可用brew install --cask claude-code或 Windowswinget install Anthropic.ClaudeCode。装完后新开终端运行claude --version;若提示找不到命令,按文档 Fix your PATH。Windows 原生环境建议安装 Git for Windows 以便 Bash 工具可用。 - 02Anthropic 登录
cd到你的项目根目录,运行claude。首次使用会提示登录:用 Claude 订阅账号或 Claude Console(API 预付费)在浏览器完成认证。已设置ANTHROPIC_API_KEY时可在提示中选择使用该密钥。企业还可通过 Bedrock、Vertex、Foundry 等云提供商接入(见官方 Credential Management)。 - 03先只读探索仓库
登录后先试只读问题,例如
what does this project do?、where is the main entry point?。Claude Code 会按需读取文件,无需手动 @ 全部源码。可选在项目根维护CLAUDE.md(或兼容AGENTS.md)写团队约定。 - 04跑第一个小改动
描述单文件小任务(例如在 README 顶部加一行项目说明)。Claude 展示变更前会征求批准;用
Shift+Tab切换权限模式,控制哪些操作可自动执行。批准后执行git diff确认;不满意可继续对话修正。不要把.env或客户数据贴进提示。
# First hour · Claude Code CLI · 2026-10
# curl -fsSL https://claude.ai/install.sh | bash
# claude --version
# cd my-repo && claude
# /login # re-auth inside session
# claude -p "explain the folder structure" # one-shot
# Docs: docs.anthropic.com/en/docs/claude-code/quickstart- 和 Codex CLI、OpenCode 怎么选?
- Claude Code 是 Anthropic 官方终端 Agent,账号走 Claude 订阅或 Console。可对照本站 Codex CLI 教程 与 OpenCode CLI 教程。
- claude 命令找不到?
- 安装后需新开终端;仍失败则按文档检查 PATH,或改用 Homebrew/WinGet 安装路径。
- 必须写 CLAUDE.md 吗?
- 非强制,但官方推荐在仓库根添加
CLAUDE.md持久化编码规范与架构说明。 - 装完能当架构白板吗?
- 不能。要对齐模块图时开 sitdraw。
先登录,再批准小 diff
首个任务控制在单文件只读或小改动;权限模式用 Shift+Tab 看清再放权。