irai の 知识文档站

Appearance

关于 Claude Code ​


一、相关链接 ​



二、Claude Code 安装 ​


2.1 Kimi 服务配置 ​



  • 接下来将 Moonshot 的 url 以及 API key 设置进环境变量的系统变量中。
txt
ANTHROPIC_AUTH_TOKEN :
你的API key
txt
ANTHROPIC_BASE_URL:
https://api.moonshot.cn/anthropic/
txt
ANTHROPIC_MODEL:
kimi-k2-turbo-preview

2.2 安装 git ​


txt
CLAUDE_CODE_GIT_BASH_PATH

D:\Program Files\Git\bin\bash.exe (找自己的 git 路径)
  • 验证安装成功：
bash
git --version

2.3 安装 Node.js ​


bash
node -v

npm -v

2.4 安装 claude code ​


    1. 通过 npm 包管理器安装
bash
npm install -g @anthropic-ai/claude-code
    1. 验证安装成功
bash
claude --version
    1. 启动网络代理
    1. 为 cmd 配置代理服务
bash
set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
    1. 颜色设置（网络环境）
    1. 登录（网络环境）：登陆方式，选择第二种，会自动从环境变量中寻找配置信息登陆进去

  • 注意事项：如果这里显示并发数限制之类的 Error 429 报错，则是 Kimi 那边的问题。

    重一点点钱后就好了，同时会赠送 15元 的免费额度。而且同时如果觉得速度比较慢，可以充够 50 元

    让等级从 Tier 0 变成 Tier 1


2.5 简单入门 ​


  • 启动 claude code :
bash
# 在项目根目录启动
claude

# 或者在某个目录指定特定任务
claude "帮我分析这个项目的结构"

  • 语言设置：在启动目录，创建文件夹 .claude，在 .claude 文件夹中创建文件 config.json
json
{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 4000,
  "temperature": 0.7,
  "auto_approve": false,
  "git_integration": true,
  "excluded_files": [
    "node_modules/**",
    ".git/**",
    "*.log",
    "dist/**"
  ],
  "language_preferences": {
    "documentation": "zh-CN",
    "code_comments": "zh-CN"
  }
}

  • 应用场景：生成项目说明文档
txt
将 C:\Users\Administrator\Desktop\xxx_demo 这个地址设置为你的工作目录 , 然后在此目录下生成一个分模块详细分析的项目说明文档

分析的过程会比较慢，这和 Kimi 的充值等级额度有关。


  • 简单项目生成：

  • Kimi K2 的代码能力还是不如 Claude、Gemini、ChatGPT 等一众国际一线编程模型，

    这里选择进行一个简单案例演示其效果

    1. 切换工作目录
bash
/add-dir <你的工作目录>
    1. 生成项目提示词
txt
在此工作目录下创建一个使用 JavaScript 编写的简单的计时器程序，要求交互界面，可以一键运行

若想从 0 到 1 生成复杂的项目，还是换更好的模型会更好


2.6 命令行输入 ​


  • ​ Claude Code 是 Anthropic 推出的终端 AI 编码助手，在交互界面中通过 斜杠命令（Slash Commands）来控制 AI 助手的行为和上下文，合理使用斜杠命令，配合自然语言输入更加顺利完成开发操作。

  • ​ 在使用 Claude Code 的时候，一般都会首先添加工作目录。

    ​ 这里一般通过一个斜杠： /来表示输入指令。这里输入如下指令选定工作目录

txt
/add-dir <你的工作目录>

  • 在创建工作目录后，使用初始化工具对该目录下的项目进行初始化分析，生成一份 CLAUDE.md 文档。.

    这个文档的作用是建立上下文，让 Claude Code 理解当前项目的目标和结构、设置代码风格和一些规则、

    设置 Claude Code 的角色。可以在进行初始化之后通过自然语言输入让其修改该初始化说明文档，

    进而实现所需的设定现在来到一个已完成的项目下，通过 /init完成项目分析的初始化


  • /init – 初始化项目记忆指南

  • 定义与语法： /init 无参数。运行此命令会扫描当前项目代码库，在项目根目录生成一个 CLAUDE.md 文

    件，作为该项目的知识指南。CLAUDE.md 通常包含项目结构摘要、主要模块说明、依赖列表等内容。

txt
/init

  • /help – 查看命令列表
txt
/help

  • /clear – 清除对话历史
txt
/clear

  • 使用场景： 当对话持续很久、上下文累积过多时，可以使用 /clear 来重置上下文窗口，保持思路清晰。

    例如在完成一个独立任务后，开始新任务前执行 /clear，Claude 将从空上下文开始理解你的下一指令。

    这在任务切换时非常有用，可以避免旧话题干扰新需求。

    此外，当 Claude 的回答出现偏离正轨或上下文混乱时，/clear 可以一键“重启”对话。


  • /compact – 压缩对话内容
txt
/compact

  • 定义与语法： /compact [instructions] 可选附加“指令”参数。此命令会将当前对话历史总结压缩，

    并以该摘要作为新对话的开场上下文。可选的 instructions 参数允许你指定压缩时的侧重点，

    例如 /compact "保留尚未解决的问题" 会让 Claude 在总结时侧重未解决问题部分。

  • 使用场景： 当会话长度接近模型上下文长度上限时，/compact 是延续长对话的救星。

    Claude 会将已有对话自动总结为更短的内容，从而释放大量上下文令牌供后续交流使用。

    这类似于有个 AI 秘书在会议途中帮你记录会议纪要，确保你们不会因为对话太长而“忘记”前情。

    不过，与 /clear 不同，

    /compact 保留了上下文的精华 —— 在新会话中 Claude 仍可以参考之前对话的摘要继续讨论。


  • /memory– 编辑会话记忆文件
txt
/memory

  • 定义与语法： /memory 无参数。用于直接打开并编辑当前项目的持久记忆文件 CLAUDE.md

    （或用户级别的全局记忆文件），方便查看和修改 Claude 的“长期记忆”。

    你也可以通过这个命令向 CLAUDE.md 添加或移除内容。

  • 使用场景： CLAUDE.md 是 Claude Code 用于初始化上下文的指南文件，

    通常包含项目简介、架构要点、代码惯例等。通过 /memory 命令，你可以随时更新该文件的内容：

    比如在初始化项目后发现 CLAUDE.md 漏掉了一些关键业务术语解释，可以输入 /memory 打开文件，

    在其中添加术语解释列表并保存。保存退出后，可以 /clear 然后开始新会话，

    Claude 将自动参照更新后的 CLAUDE.md 来回答问题，减少对术语的误解。


  • /status – 会话状态检查
txt
/status

  • 使用场景： 当你需要确认当前环境时（例如切换目录后不确定 Claude 是否跟随了新项目，

    或刚切换模型后想验证当前模型名），/status 可以立刻给出答案。它也是排查问题的起点：

    如果Claude行为异常，先看一下 /status 是否仍指向正确的路径和模型，是否有正确加载 CLAUDE.md 等。


  • /cost – 令牌与费用统计
txt
/cost

  • 使用场景： 如果你使用按量计费的 API 密钥或免费额度，随时关注对话的 token 消耗情况是个好习惯。

    执行 /cost 可以让你了解目前这场对话累计用了多少 token，并据此估算花费。在长时间编程会话或

    密集代码生成功能中，偶尔检查 /cost 有助于及时止损：发现 token 飙升可以选择提问更具体、

    压缩上下文等节约开销。另外，当你打算结束当天工作时，可以用 /cost 获取会话用量总结，

    核对是否在预算之内。


  • /config – 查看或修改配置
txt
/config

  • 使用场景： Claude Code 提供许多可定制选项，通过 /config 你可以根据个人习惯进行调整。

    例如：Autocompact（自动压缩）默认开启以防止上下文溢出，通常建议保持开启；待办事项（to-do）

    功能可以让Claude Code在长任务中列步骤，你可在配置中启用/停用；verbose输出用于调试，

    可通过 /config 打开，当需要看Claude内部推理步骤时很有用（对应快捷键 Ctrl+R 切换verbose模式）；

    还有主题配色、通知方式（如终端铃声提醒Claude完成思考）、编辑模式等。

    总之，/config 是你的个性化 Claude 控制面板。


  • /model – 切换AI模型版本
txt
/model

  • /doctor – 环境健康检查

2.7 实际开发场景 ​


善用以上斜杠命令不仅在各自场景下提升效率，更可以串联起来，形成流畅的工作流。

下面通过一个实际开发流程，展示如何组合命令完成复杂任务：

  • 场景： 你接手一个新项目，需要先熟悉代码，再开发新功能，最后提交 PR 并做审查。

    使用 Claude Code，你计划如下操作：


  • 初始化项目记忆：进入项目目录，启动 Claude Code 后，首先运行 /init 创建 CLAUDE.md 项目指南。

    这样Claude对项目有基本认识。接着你询问 “> summarize this project”，

    Claude 很快给出代码库概览，得益于刚生成的记忆文件提供的上下文。

  • 配置模型与权限：你发现默认模型对架构问题思考稍显吃力，

    于是输入 /model opus 切换到更强大的模型，以更好理解复杂代码结构。

  • 编写代码与反馈：在 Claude 的协助下，你开始编写新功能代码。Claude 直接在终端提议修改文件

    并执行了编辑。过程中会话变长，你适时使用 /compact "保留新功能相关讨论" 将上下文压缩，

    让 Claude 聚焦当前任务。当一个模块修改完成，你又用 /clear 清理对话历史，

    针对下一个模块重新开始，确保 Claude 不被上一部分内容干扰。

  • 代码功能完善 ...

  • 代码性能分析和优化 ...


2.8 集成 IDE ​


  • Claude Code 目前支持两个主要的 IDE 系列：

​ Visual Studio Code（包括 Cursor、Windsurf 等）

​ JetBrains IDEs（包括 PyCharm、WebStorm、IntelliJ 等）


  • 比如：接入 Visual Studio Code

  • 1、安装并打开 VSCode （版本需要在 1.98.0+）

  • 2、搜索并安装插件: Claude Code for VSCode

  • 3、安装之后，你的 Cursor 右上角会出现 Claude Code 的图标

  • 4、打开集成终端运行 claude，输入/ide 命令，选择vscode，连接到 IDE

  • 5、在 IDE connected 状态下，如果 Claude Code 修改了文件，可以使用 IDE 的预览功能查看修改的代码。


Copyright © 2025 irai. All rights reserved | 粤ICP备2024313367号-1