Claude Code 是 Anthropic 推出的终端优先编码助手。它能够读取你的代码库、编辑文件、运行命令，并且可以连接到兼容 Anthropic 的后端，而不仅仅使用 Anthropic 的默认 API。本指南涵盖 Claude Code CLI 的安装、斜杠命令、自定义技能，以及如何通过 Novita AI 路由请求。
如果你需要数据库、浏览器或其他外部工具，请搭配 Claude MCP 配置指南 使用。
关键要点
- Claude Code 是一个命令行助手，而不仅仅是一个提示框。
/compact、/resume、/permissions和/model是会话命令，而-p和--resume是 CLI 标志。- 自定义斜杠命令现在作为技能存在，因此
.claude/skills/和.claude/commands/都很重要。 - Novita AI 可以通过
ANTHROPIC_BASE_URL作为兼容 Anthropic 的后端使用。 - Claude Code 既适合 IDE 风格的工作流，也适合自动化的助手运行。
什么是 Claude Code？
Claude Code 是 Anthropic 的编码助手工具。CLI 在终端中运行，但同样的助手也出现在桌面应用、浏览器界面和编辑器集成中。
CLI 是最灵活的表面。它遵循 Unix 惯例，因此你可以将文件通过管道传入，使用 -p 非交互式运行，并将其集成到脚本或 CI 中。配置位于 CLAUDE.md、.claude/settings.json 和环境变量中，这使得它非常适合可重复的编码工作流。
在底层，Claude Code 向兼容 Anthropic 的 API 端点发送请求。默认情况下，该端点是 Anthropic 自己的服务，但你可以通过单个环境变量将其重定向到 Novita AI 的 LLM API。
Claude Code 安装
安装
使用 Node.js 18 或更高版本安装 CLI：
npm install -g @anthropic-ai/claude-code
首次运行
在项目目录中启动 Claude Code：
cd your-project
claude
首次使用时，Claude Code 会提示你登录。认证后，它会读取你的项目并等待指令。
项目设置
在任何新仓库中运行 /init，以生成一个初始的 CLAUDE.md 文件。Claude Code 在每个会话开始时都会读取 CLAUDE.md，因此它是放置编码标准、首选库、架构说明和审查清单的合适位置。
/init
在 /init 之后，使用 /memory 编辑文件或启用自动记忆功能，该功能会保存 Claude 在跨会话中对你的项目所做的观察。
CLI 命令参考
| 命令 | 描述 |
|---|---|
claude |
在当前目录启动交互式会话 |
claude "query" |
以初始提示启动会话 |
claude -p "query" |
运行查询并退出 |
cat file | claude -p "query" |
将内容通过管道传入查询 |
claude -c |
继续当前目录中的最近会话 |
claude -r "name" "query" |
按名称或 ID 恢复会话 |
claude update |
更新到最新版本 |
claude install stable |
安装或重新安装稳定版二进制文件 |
claude auth login |
登录到你的 Anthropic 账户 |
claude auth login --console |
使用 API 密钥计费（而非订阅）登录 |
claude auth status |
显示认证状态 |
claude mcp |
配置 MCP 服务器 |
claude doctor |
显示安装和设置诊断信息 |
CLI 标志参考
| 标志 | 作用 |
|---|---|
-p、--print |
非交互模式；打印响应并退出 |
-c、--continue |
加载最近的对话 |
-r、--resume |
按 ID 或名称恢复会话 |
--model |
设置此会话的模型 |
--permission-mode |
以特定权限模式启动 |
--add-dir |
授予对额外目录的文件访问权限 |
--system-prompt |
完全替换系统提示 |
--append-system-prompt |
追加到默认系统提示 |
--max-turns |
限制 -p 模式下的助手轮数 |
--max-budget-usd |
限制 -p 模式下的 API 花费上限 |
--output-format |
-p 模式的输出格式：text、json、stream-json |
--bg |
作为后台助手启动，立即返回 |
--worktree、-w |
在隔离的 git worktree 中启动 |
--bare |
跳过钩子、技能、插件和 MCP 的自动发现，以加快脚本调用 |
--verbose |
显示完整的逐轮输出 |
--mcp-config |
从 JSON 文件加载 MCP 服务器 |
--effort |
设置推理努力程度 |
--print + --output-format json 的组合是脚本化的标准模式。对于有预算限制的 CI 流水线，可结合 --max-budget-usd 和 --max-turns 使用。
斜杠命令文档
斜杠命令在活动会话内运行。输入 / 可查看所有可用命令，或输入 / 后跟字母进行过滤。命令只能在消息开头使用。
会话和上下文管理
| 命令 | 用途 |
|---|---|
/clear |
开始新对话；之前的会话保留在 /resume 中 |
/compact |
总结对话以释放上下文窗口空间 |
/context |
可视化上下文使用情况并查看优化建议 |
/resume |
通过名称或选择器重新打开之前的会话 |
/branch |
分叉对话以尝试不同方向 |
/rewind |
将代码和对话回滚到检查点 |
项目设置
| 命令 | 用途 |
|---|---|
/init |
为项目生成初始 CLAUDE.md |
/memory |
编辑 CLAUDE.md 文件并管理自动记忆 |
/mcp |
交互式管理 MCP 服务器连接 |
/agents |
配置子助手设置 |
/permissions |
设置工具的允许、询问和拒绝规则 |
/hooks |
查看钩子配置 |
开发工作流
| 命令 | 用途 |
|---|---|
/plan |
在进行重大更改之前进入计划模式 |
/model |
切换活动模型 |
/effort |
调整推理努力程度级别 |
/diff |
打开交互式差异查看器 |
/code-review [--fix] |
审查当前差异；--fix 应用发现结果 |
/security-review |
对挂起的更改进行深度安全审查 |
/batch <instruction> |
将大型更改分解并在并行工作树中运行 |
/background |
将会话分离，作为后台助手运行 |
实用工具
| 命令 | 用途 |
|---|---|
/help |
显示可用命令 |
/doctor |
诊断安装和设置问题 |
/usage |
显示会话成本和计划使用情况 |
/export |
将会话导出为纯文本 |
/config |
打开设置或直接设置值 |
/skills |
列出可用技能 |
自定义斜杠命令
自定义斜杠命令现在作为技能存在。现有的 .claude/commands/ 文件仍然有效，但 .claude/skills/ 是首选格式。
如何创建自定义命令
在 .claude/skills/（项目级别）或 ~/.claude/skills/（个人）下创建一个目录：
mkdir -p .claude/skills/review-pr
在该目录内创建一个 SKILL.md 文件：
---
description: 审查一个开放的 GitHub PR，检查安全问题和测试覆盖率缺口。
---
## 指令
按以下优先级审查拉取请求：
1. 识别安全漏洞。
2. 检查新代码路径的测试覆盖率。
3. 标记系统边界处缺失的错误处理。
这将创建一个 /review-pr 命令，你可以直接调用：
/review-pr
当你询问与描述匹配的问题时，Claude 也会自动加载该技能。
技能位置和优先级
~/.claude/skills/ → 个人，所有项目
.claude/skills/ → 仅此项目
.claude/commands/ 中的自定义命令仍然有效。.claude/commands/deploy.md 文件和 .claude/skills/deploy/SKILL.md 技能都会创建 /deploy 命令。
使用 Novita AI 作为 LLM 后端
Claude Code 通过 ANTHROPIC_BASE_URL 路由 API 流量。将其设置为 Novita AI 的兼容 Anthropic 端点，即可在不改变 Claude Code 工作流的情况下使用 Novita 模型。
获取 Novita AI API 密钥
注册 Novita AI 账户 以获取免费试用积分。然后打开 密钥管理页面，点击 创建新密钥，并立即复制密钥。
设置环境变量
在 Mac 和 Linux 上：
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<你的 Novita API 密钥>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
在 Windows（命令提示符）上：
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<你的 Novita API 密钥>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
ANTHROPIC_SMALL_FAST_MODEL 控制 Claude Code 用于快速内部任务（如文件查找和快速总结）的轻量级模型。
启动 Claude Code
cd your-project
claude
对于脚本化和 CI，同样适用：
cat logs.txt | claude -p "找出任何错误模式" --output-format json
Novita AI 的 LLM API 支持 Anthropic 消息格式，包括工具使用、结构化输出和流式传输，因此 Claude Code 无需修改即可正常工作。
用于隔离执行的 Agent Sandbox
如果你正在基于 Claude Code 构建自动化流水线，Novita AI 的 Agent Sandbox 为助手运行提供隔离执行环境，这对于 CI 工作流和多步骤编码任务非常有用。
Claude Code 作为 IDE 工具
Claude Code 常被描述为“一个 IDE”，因为它融入你现有的工作流而非取代它。更准确地说，它是一个与你的终端、编辑器和项目上下文协作的助手层。
VS Code 和 Cursor
从 VS Code 市场或 Cursor 市场安装 Claude Code 扩展。安装后，打开命令面板，输入“Claude Code”，然后选择 在新标签页中打开。
VS Code 集成增加了内联差异审查、文件引用、编辑前计划审查以及直接位于编辑器面板中的对话历史记录。你还可以在集成终端中与扩展一起使用 Claude Code。
JetBrains
从 JetBrains 市场安装 Claude Code 插件并重启 IDE。它在 IntelliJ IDEA、PyCharm、WebStorm 和其他 JetBrains IDE 中提供交互式差异查看和选择上下文共享。
桌面应用和 Web
Claude Code 桌面应用允许你直观地查看差异并并排运行多个会话。位于 claude.ai/code 的 Web 界面在浏览器中运行会话，无需本地设置。
常见问题
什么是 ANTHROPIC_BASE_URL，为什么它很重要？
ANTHROPIC_BASE_URL 告诉 Claude Code 将请求发送到哪个 API 端点。默认是 Anthropic 的 API。将其设置为 https://api.novita.ai/anthropic 可将流量路由到 Novita AI 的兼容 Anthropic 端点。
CLI 标志和斜杠命令有什么区别？
CLI 标志是在你从终端启动 claude 时设置的。斜杠命令在活动会话内运行，并在对话过程中改变行为。
我可以在没有 Claude 订阅的情况下使用 Claude Code 吗？
可以。claude auth login --console 使用 Anthropic Console API 密钥计费登录。如果你通过 ANTHROPIC_BASE_URL 路由到 Novita AI，则只需一个 Novita AI 账户。
自定义斜杠命令与 CLAUDE.md 有何不同？
CLAUDE.md 在每个会话开始时加载并保持在上下文中。技能仅在调用时加载，因此将 CLAUDE.md 用于始终在线的项目事实，而将技能用于可重复的过程。
Claude Code 能在 CI 中工作吗？
可以。使用 claude -p "query" --output-format json 进行非交互模式。添加 --max-budget-usd 以限制花费，添加 --max-turns 以限制执行时间。
Novita AI 是一个 AI 云平台，为开发者提供通过简单 API 部署 AI 模型的便捷方式，同时提供经济实惠且可靠的 GPU 云用于构建和扩展。
