ClaudeCode学习整理

⏱ 约 1 分钟 📁 AI

学习资料

claude code docs

使用基础

1. 安装

  • Windows安装命令：irm https://claude.ai/install.ps1 | iex
  • Linux方法一：curl -fsSL https://claude.ai/install.sh | bash
  • Linux方法二：
    • /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，安装brew后按提示命令，添加brew到shell中
    • brew install --cask claude-code@latest
  • 安装完后vim ~/.claude.json中添加配置"hasCompletedOnboarding": true (表示关闭引导流程)

2. 自定义模型

1) 方法一

vim ~/.claude/setting.json

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "api key",
        "ANTHROPIC_BASE_URL": "server",
        "ANTHROPIC_MODEL": "model name"
    }
}

2) 方法二

采用cc-switch，GUI版本安装方法如下：

# 官网找最新版安装
wget https://github.com/farion1231/cc-switch/releases/download/v3.15.0/CC-Switch-v3.15.0-Linux-x86_64.deb
dpkg -i xxx.deb
# 运行cc-switch
cc-switch

CLI版本如下：

curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
# 在.bashrc中添加：	export PATH="/root/.local/bin:$PATH"
cc-switch

3. 启动与命令

  • claude: 启动交互模式
  • claude "task": 运行一次性任务
  • claude -p "query": 一次查询操作
  • claude -c: 当前目录继续上一次会话
  • claude -r: 恢复之前的会话
  • claude --dangerously-skip-permissions: 允许所有权限启动
  • /clear: 清除历史
  • /help: 显示可用命令
  • /exit: 退出
  • /model: 切换模型
  • /init: 分析项目，在当前项目构建CLAUDE.md文件
  • /memory: 编辑记忆文件，包括CLAUDE.md等文件
  • /rename: 给当前会话命令，方便后续打开会话
  • /resume: 继续之前的会话
  • /status：显示状态信息
  • @: 用于指定目录或文件
  • !: 直接执行Bash命令
  • #: 注入记忆
  • &: 异步任务，后台执行
  • shift+tag: 切换模式，切换auto mode 、edit mode、 plan mode、default mode

4. 目录

  • ~/.claude/CLAUDE.md：适用于所有会话
  • ./CLAUDE.md：适用于当前项目
  • ./CLAUDE.local.md：个人使用，用.gitignore屏蔽掉
  • .claude/skills：存放skill
  • .claude/agents：存放agent
  • .claude/settings.json：存放配置，私人配置对应.claude/settings.local.json,
    • "permissions": { "defaultMode": "bypassPermissions"}：避免反复询问Yes/No，全部pass
    • "skipDangerousModePermissionPrompt": true：允许所有权限

5. 项目积累

SKILLs

  • /plugin: 浏览和安装skill
  • 将常见的操作编写成SKILL.md，存放到.claude/skills/目录

Claude.md

  • 用/init构建初始化的./Claude.md文件，涵盖项目架构、关键文件和常用命令。用@路径导入项目中的其他文件，避免臃肿，比如@docs/arch.md。
  • 在~/.claude/CLAUDE.md中填写个人全局的偏好
  • 在.claude/rules中按模块添加规则
  • 项目中claude犯错需要记录，比如Save it to Claude.md
  • 如果claude没有遵守规则时，问它Why don't you follow rule: xxxx

SKILLs与Claude.md区分

  CLAUDE.md Skills (SKILL.md)
加载时机 每次对话始终加载（常驻上下文） 按需加载（AI 判断相关时才注入）
本质 项目的”宪法” / 背景知识 可插拔的”专业技能包”
类比 员工入职手册（人人必读） 专项操作手册（用到才翻）
特点 流程 + 专业知识 + 按需激活 身份 + 规则 + 始终在线

6. 工作流

探索 -> 规划 -> 实现 -> 提交

  • 探索(plan mode)：先阅读和理解环境、代码等等，举例：

    read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.

  • 规划(plan mode)：要求Claude创建实施计划，举例：

    I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

    按Ctrl + G可以直接计划

  • 实现(default mode)：切换到默认模式，让其按计划进行，举例：

    implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.

  • 提交(default mode): 要求commit和创建PR

    commit with a descriptive message and open a PR

评论