Claude Code 保姆级安装

2026-10-01

安装 Claude Code CLI，用天天AI 跳过官方登录，配置后即可在终端写代码。

想在终端里直接让 AI 读项目、改代码、跑命令？

试试 Claude Code：Anthropic 官方出的终端 AI Coding Agent。装好、配上天天AI，就能开聊。

本文只讲 CLI（命令行）。桌面端、VS Code / JetBrains 扩展有兴趣可自行去官网看，这里不展开。

关于文中的链接： 文中会挂官网文档链接，主要是给想深入了解或事后备忘用的。按本文步骤照做一般就够了，不必把每个链接都点开看一遍。

想玩多角色编排（规划 / 执行拆开），可以再看：OpenCode + oh-my-opencode 保姆级安装。

一、它是什么

Claude Code 是 Anthropic 官方的终端 Agent：能读你的代码仓库、改文件、跑 shell、帮你处理 Git，用自然语言跟它说话就行。

安装与系统要求：https://code.claude.com/docs/en/setup
快速上手：https://code.claude.com/docs/en/quickstart

二、安装

官方推荐用 Native 安装器（装完会后台自动更新）。按你的系统选一条。

情况一：macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

装完新开一个终端，再确认：

claude --version

能打出类似 2.1.211 (Claude Code) 就对了。

情况二：Windows

PowerShell（提示符前面有 PS）：

irm https://claude.ai/install.ps1 | iex

CMD（提示符没有 PS）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

装完同样新开终端，跑 claude --version。

小提示：原生 Windows 上建议顺手装 Git for Windows，Claude Code 才能用 Bash 工具；

三、配置（先跑通最小闭环）

这一步的目标很简单：让 Claude Code 能连上模型开始干活。
官方那套「浏览器登录 Claude 订阅 / Console」又贵又绕，新手直接跳过。本文用 天天AI 一把配好。

关于官方登录
装完第一次跑 claude，默认会让你去浏览器登录 Claude 账号（见 https://code.claude.com/docs/en/quickstart）。

本文不走这条。 按下面把天天AI 写进配置文件即可。若启动时提示「批准 API Key」，选同意就行——不用去登 Claude 官网账号，也不用在会话里敲 /login。

正确做法：

先写好下面的配置
再启动 claude
直接用中文说需求

1. 先拿到天天AI 的密钥

打开 https://ai.ttshuli.com 注册并登录
进控制台，创建一个 API 密钥（一般长这样：sk-mt-...）
复制保存好，后面要贴进配置文件；别发到群里、别截图露出来

站点文档页也有同款片段，可对照：https://ai.ttshuli.com/docs.html

2. 写配置文件：`settings.json`

目录（没有就新建）：

macOS / Linux：~/.claude/
Windows：C:\Users\你的用户名\.claude\

新建或编辑 settings.json，粘贴下面整段（把密钥换成你的）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.ttshuli.com",
    "ANTHROPIC_API_KEY": "这里换成你的密钥",
    "ANTHROPIC_MODEL": "auto",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "auto",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "auto",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "200000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "180000"
  }
}

要点：

ANTHROPIC_BASE_URL 写站点根 https://ai.ttshuli.com，不要写成 /v1。Claude Code 走的是 Anthropic 协议；OpenCode 那篇才用带 /v1 的 OpenAI 兼容地址。
几个 *_MODEL 都指到 auto，让天天AI 自己选最优模型。名单会定期更新，新手别死盯某个具体模型名。
CLAUDE_CODE_MAX_CONTEXT_TOKENS 写最大上下文窗口 200000（纯数字字符串，不要写成 200k）。Claude Code 对 auto 等未识别模型名不会从接口读窗口，必须靠这个字段假定上限。
CLAUDE_CODE_AUTO_COMPACT_WINDOW 写 180000：到达该阈值时自动压缩，比最大窗低一点留余量。只设最大窗、不设这个时，进度条可能到 100% 仍不压缩，接着被上游超限打死。两个都要写，且都用纯数字。

另外在家目录再建 ~/.claude.json（注意是 ~ 下，不是 ~/.claude/ 目录里）：

{
  "hasCompletedOnboarding": true
}

Windows 对应路径：C:\Users\你的用户名\.claude.json。

3. 打开 Claude Code

进到你的项目目录，启动：

cd /你的项目路径
claude

进去之后直接打字，例如：

这个项目是干什么的？

能正常回答，就说明配置通了。

四、怎么用（入门够用）

先问再改

第一次进项目，先让它摸清结构，再动手改代码。例如：

这个项目用了哪些技术？入口在哪？

再给一个具体任务：

给用户列表页加上按昵称搜索，复用现有表格组件，别改接口协议

说清楚「改哪、约束是什么」，比只说「修一下」省 Token、也少返工。

权限：`Shift+Tab`

它要改文件或跑命令时，可能会问你是否同意。看清楚再选。

随时按 Shift+Tab 可以切换当前会话的权限模式（要不要事事确认）。新手先偏保守；熟了再放宽。

常用启动方式

在系统终端里：

命令	作用
`claude`	进入当前目录的交互会话
`claude -c`	继续这个目录上一次对话
`claude --dangerously-skip-permissions`	进入当前项目，并自动批准权限；不想总是手动确认时用
`claude --dangerously-skip-permissions -c`	同上，且打开后继续上一次会话
`claude -p "一句话"`	问完就退出（适合一次性查询）
`claude "修一下构建报错"`	带着初始任务开聊

会话里常用

命令	作用
`/help`	看有哪些斜杠命令
`/clear`	清空当前对话上下文
`/exit`	退出（也可连按两次 Ctrl+D）

输入 / 可以唤出命令列表；↑ 翻历史输入。

可选：项目里放一份 `CLAUDE.md`

在项目根目录放 CLAUDE.md，写上技术栈、目录约定、别乱动的红线等。有的话它更懂你的项目；没有也不妨碍先试用。

五、省钱与排障

你前面已经用天天AI 接好了，比官方订阅通常便宜一截。再用几条习惯继续省：

模型保持 auto，让系统选；小活别硬指定最贵的那档
任务说清楚范围（改哪个文件、不要动什么）
大改可以先让它「只分析、先别改代码」，确认方案再动手

常见问题：

claude 找不到：新开终端；确认 ~/.local/bin（或安装器提示的路径）在 PATH 里；跑 claude doctor
仍弹官方登录 / 浏览器授权：检查 ~/.claude/settings.json 是否写对、ANTHROPIC_API_KEY 与 ANTHROPIC_BASE_URL 是否生效
连不上 / 报鉴权错误：回控制台确认密钥没删、余额够；Base URL 别多写了 /v1
要换密钥：改 settings.json 里的 ANTHROPIC_API_KEY 即可

官网速查

Claude Code 安装：https://code.claude.com/docs/en/setup
Claude Code 快速上手：https://code.claude.com/docs/en/quickstart
天天AI：https://ai.ttshuli.com
天天AI 接入文档：https://ai.ttshuli.com/docs.html
OpenCode 教程（多角色编排）：/articles/opencode-oh-my-opencode.html

装完先跑：写好 ~/.claude/settings.json 和 ~/.claude.json → cd 进项目 → claude → 问一句「这个项目是干什么的」；通了再丢一个小改动任务。