很多开发者只知道 Claude 网页聊天，却不清楚 Claude Code 是 Anthropic 官方推出的智能编程代理，同时提供 CLI 命令行工具 和 Claude 桌面应用内置 Code 面板 两种使用形态。不用来回复制粘贴代码，AI 可以直接读取项目目录、修改文件、执行终端命令，深度融入开发工作流稀土掘金。
一、Claude Code 是什么？
Claude Code 是面向项目级开发的 AI 编码 Agent，区别于普通对话模式：
- 可以读取本地整个项目目录，理解完整代码上下文；
- 支持创建 / 编辑文件、执行 Shell 命令、查看 Git 变更；
- 两种使用入口：独立命令行 CLI、Claude 桌面客户端内置 Code 标签页；
- 适合重构项目、批量修复 Bug、编写单元测试、搭建项目骨架等复杂编码任务Anthropic。
注意：桌面端 Code 面板通常需要 Claude Pro 订阅，CLI 支持账号登录或 API Key 两种认证方式。
二、Claude Code 命令行（CLI）完整上手
1. 安装官方 CLI
官方推荐原生脚本安装（macOS / Linux / WSL）
bash
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell 管理员执行：
powershell
irm https://claude.ai/install.ps1 | iex
也可通过 npm 全局安装：
bash
npm install -g @anthropic-ai/claude-code
安装完成后，新开终端，输入 claude 验证是否安装成功。
2. 两种认证方式
- 交互式账号登录（推荐，和 Claude 桌面同账号）
bash
claude login
跟随指引打开网页完成授权登录。
- API Key 方式（自动化脚本、CI 场景） 设置环境变量：
bash
# Mac / Linux
export ANTHROPIC_API_KEY="sk-ant-xxx"
# Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-ant-xxx"
3. 基础使用方式
方式 1：交互式会话（最常用）
进入你的项目根目录，启动交互模式：
bash
cd /your/project/path
claude
进入交互界面后，直接用自然语言下达指令：
plaintext
帮我给所有接口增加统一异常处理
阅读 README，补全项目开发文档
修复控制台打印的报错，提交 git commit
内置交互斜杠常用命令：
/clear：清空会话上下文，开启新任务/compact：压缩对话上下文，节省 token/status：查看当前账号、模型、权限状态/model：切换模型（Sonnet / Opus / Haiku）
方式 2：一次性单行任务（脚本调用）
不用进入交互界面，直接执行单次任务：
bash
claude "查找项目所有 TODO 注释并整理成文档"
支持附加参数指定模型：
bash
claude --model claude-opus-4 "重构这个模块，优化性能"
4. CLI 实用小技巧
@文件路径：快速引用项目文件，自动带入上下文
plaintext
@src/main.py 优化这段代码
!前缀：直接执行 bash 命令
plaintext
!ls src && !git status
- 权限控制：默认修改文件会弹窗确认；自动化场景可加
--dangerously-skip-permissions（谨慎使用）claude-ant…
三、在 Claude 桌面应用中使用 Claude Code（图形界面）
如果你不习惯纯终端操作，新版 Claude 桌面客户端内置了 Code 标签页，等价于可视化版 Claude Code，操作更直观，支持 Diff 预览、分屏多会话、内置终端。
完整操作步骤
- 下载安装官方 Claude Desktop App（macOS / Windows），使用订阅账号登录；
- 在客户端顶部侧边栏，切换到 Code 标签页（Code 面板）；
- 新建会话：选择 Local 本地模式 →
Select folder，选中你的本地项目文件夹； - 设置权限模式：控制 AI 自动执行命令、修改文件的自主程度（新手建议默认人工确认变更）；
- 在底部输入框输入任务指令，回车启动 AI 编码会话；
- 右侧可视化查看文件差异 Diff，可逐条接受、拒绝代码变更；
- 内置集成终端，直接运行构建、测试脚本，不用切出应用；
- 支持同时新建多个独立 Session，并行处理多个开发任务，上下文互相隔离GitHub。
桌面端 Code 面板优势对比 CLI
✅ 可视化 Diff，清晰看到每一处代码改动，降低误改风险
✅ 分屏布局：文件树、编辑器、差异预览、终端一体化
✅ 会话管理更直观，一键保存 / 复制历史任务
❌ 依赖桌面客户端与 Pro 订阅，无法在服务器、CI 环境运行
补充：桌面 Code 和 CLI 底层是同一个 Claude Code Agent，能力基本对齐，只是交互形态不同。
四、怎么选：CLI 还是桌面 Code 面板？
- ✅ 优先选 CLI：服务器远程开发、自动化脚本、习惯终端工作流、Vim/Neovim 用户、CI 流水线集成
- ✅ 优先选 Claude App Code 面板：本地桌面开发、需要可视化对比代码变更、新手不想记终端命令、多任务分屏操作
五、最佳实践建议
- 启动 Claude Code 前，先做好 Git 提交备份，方便回滚 AI 修改；
- 复杂项目建议根目录新建
CLAUDE.md，写入项目架构、编码规范，作为长期记忆； - 大重构优先使用 Opus，日常调试、脚本生成使用 Sonnet，简单检索用 Haiku，平衡成本与性能；
- 不要开放完全自主权限，重要文件变更建议人工审核 Diff；
- CLI 适合自动化批量任务，桌面 Code 适合交互式迭代调试，两者可以搭配使用。
总结
Claude Code 不止是命令行工具，也是 Claude 桌面应用内置的可视化编码能力：
- 服务器、终端重度使用者：直接安装 CLI，
claude启动会话，嵌入现有终端工作流； - 本地桌面开发者：打开 Claude App → Code 面板，选择项目文件夹，可视化完成编码重构；
作为 Agent 式编程工具，Claude Code 打通了 “读懂项目 – 修改文件 – 执行命令 – 预览变更” 完整闭环，替代大量手动复制 AI 代码的重复工作，显著提升个人开发效率。
如果你需要，我还可以补充：Claude Code 接入 IDE（VSCode）插件教程，以及常见报错排查清单，方便你完整落地这套工作流。
