LinkToAGI 站点配置教程

文档版本 2026.07 · 最后更新 2026-07-10

适用于 Claude Code、Codex、Gemini CLI、Roo Code、Kilo Code、Cherry Studio 与 ChatBox

开始前先创建本站令牌 首次使用请先注册账号并完成邮箱验证码验证;API Key 在控制台的“令牌管理”中创建,可用模型和令牌分组以控制台实际显示为准。 打开控制台创建令牌
Claude Codehttps://api.linktoagi.comAnthropic-compatible
Codex / OpenAI 客户端https://api.linktoagi.com/v1OpenAI-compatible
Gemini CLIhttps://api.linktoagi.comGemini-compatible

迄今为止最先进的代码助手

  • Claude Code是为编写代码而生的Agent,您可以像与人对话一样,使用自然语言轻松实现的想法,无需任何学习成本。
  • 只需等待一杯咖啡的时间,Claude Code就可以为您解决所有问题。

支持的 IDE

  • Visual Studio Code(包括 Cursor 和 Windsurf 等流行分支)
  • JetBrains IDEs(包括 PyCharm、WebStorm、IntelliJ 和 GoLand)

一、Claude Code(稳定性/性价比/口碑之王🏆)

🌏官网:点击访问官方网站(全面开启在线充值随用随充)

🌏Key创建步骤


✅ 纯正Max号池搭建:拒绝第三方掺假,确保每次调用都是不降智的官方品质。
🚫 无需魔法:国内外直连,秒速响应,稳定不封号
📊 (独家)缓存透明计费:每一笔记录都清晰可查,不乱扣费(支持任意第三方检测)
📊 (独家)独家技术:行业内命中缓存率超高,减少token调用(我们的token更耐用
🚀 (独家)兼容官网各种报错(我们更少的报错)
🚀 (独家)支持在RooCode/Kilo Code/ CherryStudio/ ChatBox中使用(下面教程三)
🚀 支持官方包方式安装:配置环境变量

1.1、❤️安装方式

安装官方 Claude Code
npm install -g @anthropic-ai/claude-code claude --version
以下是 Windows、macOS 和 Linux 系统下设置 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 环境变量的详细方法:
Windows 系统展开配置

方法1(推荐):配置settings.json

  • 创建(如果不存在)或编辑 C:\Users{用户名}.claude\settings.json,输入以下值并保存
      { "env": { "ANTHROPIC_AUTH_TOKEN": "输入创建的Key密钥", "ANTHROPIC_BASE_URL": "https://api.linktoagi.com/", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1 }, "permissions": { "allow": [], "deny": [] } }

方法2:临时设置(不推荐)

  • PowerShellCMD 中执行:
      # PowerShell $env:ANTHROPIC_BASE_URL="https://api.linktoagi.com/" $env:ANTHROPIC_AUTH_TOKEN="输入创建的Key密钥" # CMD set ANTHROPIC_BASE_URL=https://api.linktoagi.com/ set ANTHROPIC_AUTH_TOKEN=输入创建的Key密钥

        方法3:永久设置(不推荐)

    • 图形界面
      1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
      2. 在「用户变量」或「系统变量」中新建:
        • 变量名:ANTHROPIC_BASE_URL
        • 变量值:https://api.linktoagi.com/
      3. 同样方法添加 ANTHROPIC_AUTH_TOKEN
        • 变量值:创建的Key密钥
    • PowerShell 永久设置
        [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.linktoagi.com/', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '替换为您的API Key', 'User')
      1. 重启终端后生效。

macOS 系统展开配置

方法1(推荐):配置settings.json

  • 创建或编辑 ~/.claude/settings.json,并填入以下内容
      { "env": { "ANTHROPIC_AUTH_TOKEN": "替换为您的API Key", "ANTHROPIC_BASE_URL": "https://api.linktoagi.com/", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1 }, "permissions": { "allow": [], "deny": [] } }

        方法2:临时设置(不推荐)

    • 终端 中执行:
        export ANTHROPIC_BASE_URL="https://api.linktoagi.com/" export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"
    •   方法3:永久设置(不推荐)

    • 编辑 shell 配置文件(根据使用的 shell 选择):
        # 如果是 bash(默认) echo 'export ANTHROPIC_BASE_URL="https://api.linktoagi.com/"' >> ~/.bash_profile echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.bash_profile # 如果是 zsh echo 'export ANTHROPIC_BASE_URL="https://api.linktoagi.com/"' >> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.zshrc
    • 立即生效:
        source ~/.bash_profile # 或 source ~/.zshrc

Linux 系统展开配置

    方法1:临时设置(仅当前终端有效)

  • 终端 中执行:
      export ANTHROPIC_BASE_URL="https://api.linktoagi.com/" export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"
  •     方法2:永久设置

  • 编辑 shell 配置文件(根据使用的 shell 选择):
      # 如果是 bash echo 'export ANTHROPIC_BASE_URL="https://api.linktoagi.com/"' >> ~/.bashrc echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.bashrc # 如果是 zsh echo 'export ANTHROPIC_BASE_URL="https://api.linktoagi.com/"' >> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.zshrc
  • 立即生效:
      source ~/.bashrc # 或 source ~/.zshrc
  •     方法3:配置settings.json(推荐)

  • 创建 ~/.claude/settings.json 文件,内容如下:
      { "env": { "ANTHROPIC_AUTH_TOKEN": "替换为您的API Key", "ANTHROPIC_BASE_URL": "https://api.linktoagi.com/", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1 }, "permissions": { "allow": [], "deny": [] } }

  •     通用验证方法

        在所有系统中,可以通过以下命令验证是否设置成功:
    # macOS/Linux echo $ANTHROPIC_BASE_URL test -n "$ANTHROPIC_AUTH_TOKEN" && echo "API Key 已设置" # Windows PowerShell echo $env:ANTHROPIC_BASE_URL [bool]$env:ANTHROPIC_AUTH_TOKEN # Windows CMD echo %ANTHROPIC_BASE_URL% if defined ANTHROPIC_AUTH_TOKEN (echo API Key 已设置) else (echo API Key 未设置)

        1.2、Claude Code第三方客户端调用(已开放)

    1.     在Roo Code/Kilo Code中使用

      • API供应商选择Anthropic
      • 填写API密钥
      • 使用自定义基础URL,填写https://api.linktoagi.com/
    1.     在Cherry Studio中使用

      • 新增供应商平台
      • 类型选择Anthropic
      • 填写API密钥,API地址https://api.linktoagi.com/
      • 点击管理拉取模型加入
    1.     在ChatBox中使用

      • 模型提供方选择Claude
      • 填写API密钥
      • API地址填写https://api.linktoagi.com/v1
    1.     在VSCode中使用

         安装官方claudecode插件
        vscode中claudecode新版本插件强制登录解决方案: 新建 ~/.claude/config.json 内容: { "primaryApiKey": "fox" }

    二、Codex 接入 LinkToAGI 完整教程

    无需 ChatGPT 账号 · 无需订阅 · 使用本站令牌即可

    安装 Codex,配置 LinkToAGI API Key,直接开始工作

    本站推荐使用 Codex CLI 或官方 IDE 扩展接入 LinkToAGI。用户只需要在控制台创建一个令牌,并填写本站 API 地址,不需要注册或登录 ChatGPT,也不需要执行 codex login

    最重要的结论:使用本站的自定义提供方配置后,Codex 会从环境变量读取本站令牌,并直接请求 https://api.linktoagi.com/v1。完成配置后即可开始使用。

    2.1、LinkToAGI 配置特点

    不需要 ChatGPT 账号

    不依赖 ChatGPT 登录状态、账号地区或浏览器 OAuth,配置本站令牌后即可使用本地 Codex。

    按使用量充值

    无需为了偶尔使用购买固定月度套餐;用多少充多少,余额、调用记录和消耗可在控制台查看。

    国内网络直接访问

    客户端统一连接本站 API 地址,减少直接访问境外官方接口时可能遇到的网络环境问题。

    一枚令牌,多种客户端

    同一套 OpenAI-compatible 地址可用于 Codex CLI、IDE 扩展及其他兼容客户端,迁移和管理更简单。

    模型集中管理

    可用模型、令牌分组和额度以 LinkToAGI 控制台为准,不需要分别维护多个模型平台的密钥。

    账单记录更直观

    在本站控制台集中查看余额和调用日志,便于定位 401、额度不足、模型权限等问题。

    2.2、推荐入口怎么选?

    Codex 桌面 App可选图形界面

    适合项目和任务管理;不同版本的自定义提供方支持可能变化,本站标准接入以 CLI/IDE 为准。

    2.3、五分钟完成配置:无需登录 ChatGPT

    正确顺序:创建本站令牌 → 安装 Codex → 写配置文件 → 设置环境变量 → 启动 Codex。不要在配置完成前先运行 codex,否则可能进入官方登录引导。

    第一步:在 LinkToAGI 创建令牌

    首次使用请先注册本站账号:填写邮箱并获取验证码,完成邮箱验证后再登录控制台。

    1. 打开 LinkToAGI 控制台 并登录本站账号。
    2. 进入“令牌管理”,点击新建令牌。
    3. 选择需要的分组和额度,复制生成的 sk-... 令牌。
    4. 同时查看“模型广场”或控制台模型列表,记下当前令牌允许使用的模型名称。

    第二步:安装 Codex CLI

    macOS / Linux / WSL 推荐使用官方安装器:

    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    如果已经安装 Node.js,也可以使用 npm:

    npm install -g @openai/codex

    只检查版本,暂时不要启动登录流程:

    codex --version

    第三步:创建 config.toml

    macOS / Linux / WSL:

    mkdir -p ~/.codex nano ~/.codex/config.toml

    Windows PowerShell:

    New-Item -ItemType Directory -Force $HOME\.codex notepad $HOME\.codex\config.toml

    将下面内容完整复制到配置文件:

    model_provider = "linktoagi" model = "gpt-5.5" model_reasoning_effort = "high" approval_policy = "on-request" sandbox_mode = "workspace-write" [model_providers.linktoagi] name = "LinkToAGI" base_url = "https://api.linktoagi.com/v1" wire_api = "responses" env_key = "LINKTOAGI_API_KEY"
    模型名称必须匹配:示例使用 gpt-5.5。如果控制台显示的可用模型名称不同,请修改 model = "...";不要凭感觉填写不存在的模型。

    第四步:设置 LinkToAGI API Key

    macOS / Linux / WSL,仅当前终端生效:

    export LINKTOAGI_API_KEY="sk-替换成你在本站创建的令牌"

    macOS / Linux / WSL,长期生效:

    # zsh 用户 nano ~/.zshrc # 在文件末尾添加:export LINKTOAGI_API_KEY="sk-替换成你的令牌" source ~/.zshrc # bash 用户 nano ~/.bashrc # 在文件末尾添加:export LINKTOAGI_API_KEY="sk-替换成你的令牌" source ~/.bashrc

    Windows PowerShell,写入当前用户环境:

    [Environment]::SetEnvironmentVariable( "LINKTOAGI_API_KEY", "sk-替换成你的令牌", "User" )

    Windows 设置后请完全关闭并重新打开 PowerShell、VS Code 或 Cursor。

    第五步:启动并验证

    进入一个代码项目后启动 Codex:

    cd /你的项目目录 codex

    进入 Codex 后执行:

    /status

    重点确认:

    • model_provider 显示为 linktoagi
    • 模型名称与控制台允许的名称一致。
    • 第一次提问能够正常返回结果,控制台调用日志出现对应记录。
    这里不需要执行:codex logincodex login --device-auth 或浏览器 ChatGPT 登录。只要 config.tomlLINKTOAGI_API_KEY 正确,Codex 就会使用本站中转。

    2.4、下载 Codex 桌面 App(可选)

    桌面 App 适合图形化管理项目、文件和长任务,但不是使用本站 API 的必需步骤;本站标准接入以 CLI/IDE 配置为准。

    本站用户建议:先按上一节完成 CLI 配置并验证可用,再尝试桌面 App。若当前 App 版本没有读取自定义提供方,请直接使用 CLI/IDE。

    2.5、在 VS Code、Cursor、Windsurf 中使用

    1. 先确保上一节的 Codex CLI 已经能够正常调用 LinkToAGI。
    2. 安装 OpenAI 官方 ChatGPT / Codex 扩展,认准发布者 OpenAI。
    3. 点击左侧 Codex 图标;看不到时打开命令面板,运行 Codex: Open Codex Sidebar
    4. IDE 扩展与 CLI 读取同一个 ~/.codex/config.toml。修改配置或环境变量后,需要完全重启编辑器。
    5. 打开文件或选中代码后提问,完成修改后检查摘要和 diff,再决定保留或继续调整。
    Codex 官方 IDE 扩展安装示例
    扩展仍显示登录页?先在 IDE 集成终端运行 codex 验证配置。如果 CLI 正常,执行“Developer: Reload Window”或完全退出编辑器再打开;也可以直接在集成终端使用 Codex CLI。
    展开 Codex 进阶使用与排障提示词、AGENTS.md、权限、WSL、客户端与官方资料

    2.6、如何给 Codex 下一个好任务

    任务说明建议包含四部分:目标、范围、约束、完成标准。这样可以减少无关修改,也能让消耗更可控。

    目标:修复订单页重复提交的问题。 范围:只修改 web/src/order 和相关测试,不调整数据库结构。 约束:保持现有接口兼容,不增加新依赖。 完成标准:补充回归测试,运行相关测试和 lint,最后列出修改文件与验证结果。

    对于陌生项目,推荐分两轮:

    第一轮:先复现并定位根因,不要修改文件;给出证据和建议方案。 第二轮:确认方案后实施修复,运行测试,并检查 git diff 是否有无关改动。

    推荐的第一次任务

    • 先不要修改代码,解释项目技术栈、启动命令和目录结构。
    • 分析一段报错日志,给出最可能原因和验证方法。
    • 为一个已有函数补充单元测试。
    • 修复一个可以稳定复现的小问题,并运行相关测试。

    使用 AGENTS.md 保存项目规则

    在仓库根目录运行 /init 可以生成 AGENTS.md。建议写入启动命令、测试命令、代码风格、不可修改目录,以及什么条件才算任务完成。Codex 以后进入该仓库时会自动读取。

    2.7、模型、权限与用量建议

    设置建议
    model填写控制台实际允许的模型;不存在的模型会返回 404 或模型无权限。
    model_reasoning_effort复杂架构和排障可用 high;简单改文案或小修改可降低推理强度。
    approval_policy新手保留 on-request,执行高影响命令前由用户确认。
    sandbox_mode推荐 workspace-write,默认只允许在项目工作区内修改。
    控制消耗缩小任务范围、减少无关文件、及时结束已经完成的长会话,并在控制台查看调用记录。

    常用命令速查

    命令用途
    /status查看当前模型、提供方、目录和权限
    /model切换模型和推理强度
    /permissions查看或调整本次任务的文件与命令权限
    /review审查未提交修改、指定提交或相对分支的差异
    /init创建项目级 AGENTS.md 指令文件
    codex resume恢复以前的本地会话
    codex -m 模型名本次启动临时切换模型

    2.8、Windows 与 WSL2

    • 普通 Windows 项目可以直接使用 PowerShell 安装 npm 版 Codex。
    • 项目依赖 Linux 工具链时推荐使用 WSL2;新版本 Codex 已不支持 WSL1。
    • WSL2 中的 ~/.codex 与 Windows 的 %USERPROFILE%\.codex 默认是两套目录,需要分别配置。
    • 大型项目放在 WSL 的 ~/code/项目名,不要放在 /mnt/c 下,以免文件访问过慢。
    # 管理员 PowerShell wsl --install # 进入 WSL 后 curl -fsSL https://chatgpt.com/codex/install.sh | sh mkdir -p ~/.codex

    2.9、常见问题排查

    现象检查与处理
    启动后要求登录 ChatGPT说明 Codex 没有读取到自定义提供方。检查 ~/.codex/config.toml 路径、model_provider = "linktoagi" 和环境变量,然后完全重开终端。
    codex: command not found重新打开终端;确认安装目录已经加入 PATH;npm 安装时检查 npm prefix -g
    401 / Unauthorized确认 LINKTOAGI_API_KEY 已设置、令牌没有多余空格、令牌未被禁用且仍有余额。
    404 / endpoint not found基础地址必须是 https://api.linktoagi.com/v1,并配置 wire_api = "responses"
    模型不存在或无权限到控制台检查令牌分组和模型列表,把 model 改成完全一致的名称。
    CLI 可用,IDE 不可用确认 IDE 与 CLI 属于同一系统环境;重启 IDE;Windows 原生与 WSL 需要分别配置。
    请求超时或连接失败先打开控制台确认服务可访问,再检查系统代理、防火墙和基础地址有没有写错。
    余额消耗较快缩小任务范围,避免重复读取整个仓库;选择合适模型和推理强度,并查看控制台调用日志。

    2.10、Cherry Studio 等第三方客户端

    支持 OpenAI-compatible 接口的客户端通常填写:

    API 地址https://api.linktoagi.com/v1
    API KeyLinkToAGI 控制台创建的 sk-... 令牌
    模型控制台实际允许的模型名称

    普通聊天客户端不会自动拥有 Codex CLI 的本地读写文件、运行命令、沙箱和代码审查能力;需要完整编码 Agent 能力时请选择 Codex CLI 或 IDE 扩展。

    在第三方客户端中配置 Codex API 示例

    2.11、官方资料

    下面的外部链接都会在新窗口打开,不会关闭当前教程。


    三、Gemini CLI安装教程

    1、安装Gemini CLI

    使用 npm 进行安装 cmd
    npm install -g @google/gemini-cli

    2、配置文件

    编辑文件 ~/.gemini/.env
    GOOGLE_GEMINI_BASE_URL="https://api.linktoagi.com" GEMINI_API_KEY=你的APIKey GEMINI_MODEL=gemini-3-pro-preview
    编辑或创建文件 ~/.gemini/settings.json
    { "ide": { "enabled": true }, "security": { "auth": { "selectedType": "gemini-api-key" } } }
    若出现401如图:(解决:输入/auth,然后填上key)
    附录:Claude Code 进阶功能与官方资料命令、IDE、WSL、MCP 与常见问题
    1. 直接进行交互:

    • Claude Code 提供两种主要的交互方式:
      • 交互模式:运行 claude 启动 REPL 会话
      • 单次模式:使用 claude -p "查询" 进行快速命令
      • 您可以参考:
      • # 启动交互模式 claude # 以初始查询启动 claude "解释这个项目" # 运行单个命令并退出 claude -p "这个函数做什么?" # 处理管道内容 cat logs.txt | claude -p "分析这些错误"
    • 对于 Claude Code Client的常用参数和功能,您可以访问官方文档:CLI 使用和控制 - Anthropic
    1. 支持连接到主流IDE

    • 您可以直接在IDE中看到Claude Code的改动,在IDE中与其交互。
    • 现在支持 VSCode 与 JetBrains
    • 如果您使用Linux / macOS,您可以直接使用该插件
    • 您可能需要手动指定IDE,通过在Claude Code进行以下交互选择
    > /ide
    1. 支持连接到Cursor:

    方法一:直接安装插件

    方法二、基于wsl

    使用本质:在cursor中本地连接Ubuntu终端使用Claude Code,可以可视化代码的操作!步骤如下:
    序号
    操作
    图例
    1
    打开cursor
    2
    点击左下角终端图标
    3
    在弹出来的选项框里点击第三个;在弹出来的新选项框里点击Ubuntu选项,cursor就会自动连接Ubuntu系统。


    连接完成后显示
    没有Connect to WSL using Distro选项
    若打开只有2个选项,没有五个选项,原因是没有安装扩展,安装扩展之后重启即可。
    按下图依次点击,进入扩展界面。
    扩展详情页
    在搜索框里搜索WSL,找到图示这个扩展,不要选错,点击安装。安装过程需要翻墙,不然可能会因为网络安装失败。
    此时再点击就有5个选项,选择第三个就行!
    1. 切换模型 Claude 4 Opus 与 Claude 4 Sonnet:

    • 我们强烈推荐您使用Claude 4 Sonnet(默认的),其使用体验与Claude 4 Opus没有明显差别,但计费倍率仅为1/5。
    • 如果更换请查阅官网指令
    1. 压缩上下文以节省额度:

    • Claude Code 通常会有长上下文,我们建议您使用以下斜杠命令来压缩以节省点数,较长的上下文往往需要更多点数。
    /compact [instructions] #您可以添加说明
    1. 恢复以前的对话:

    • 使用以下命令可以恢复您上次的对话
        claude --continue
      • 这会立即恢复您最近的对话,无需任何提示。
    • 您如果需要显示时间,可以输入此命令
        claude --resume
      • 这会显示一个交互式对话选择器,显示:
        • 对话开始时间
        • 初始提示或对话摘要
        • 消息数量
      • 使用箭头键导航并按Enter选择对话,您可以使用这个方法选择上下文。
    1. 处理图像信息:

    • 您可以使用以下任何方法:
      • 将图像拖放到Claude Code窗口中(在macOS上)
      • 复制图像并使用Ctrl+v粘贴到CLI中(在macOS上)
      • 提供图像路径
      • > 分析这个图像:/path/to/your/image.png
    • 您可以完全使用自然语言要求他进行工作,如:
        > 这是错误的截图。是什么导致了它? > 这个图像显示了什么? > 描述这个截图中的UI元素 > 生成CSS以匹配这个设计模型 > 什么HTML结构可以重新创建这个组件?
    1. 深入思考:

    • 您需要通过自然语言要求其进行深入思考
        > 我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。 > 思考这种方法中潜在的安全漏洞 > 更深入地思考我们应该处理的边缘情况
      • 推荐您在使用复杂问题的时候使用这一功能,这也会消耗大量的额度点数。
    1. 通过 Claude.md 存储重要记忆:

    • 您可以使用以下命令设置一个CLAUDE.md文件来存储重要的项目信息、约定和常用命令。
        > /init
      • 包括常用命令(构建、测试、lint)以避免重复搜索
      • 记录代码风格偏好和命名约定
      • 添加特定于您项目的重要架构模式
      • CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。
      • 更多关于记忆的设置,您可以访问此官方文档了解:Claude Code 概述 - Anthropic
      • 在官方文档中,此部分记录了记忆的常用用法:管理Claude的内存 - Anthropic
    1. 自动化 CI 和基础设施工作流程

    • Claude Code 提供非交互模式,用于无头执行。这在非交互上下文(如脚本、管道和 Github Actions)中运行 Claude Code 时特别有用。
    • 使用 --print (-p) 在非交互模式下运行 Claude,如:
        claude -p "使用最新更改更新 README" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Write --disallowedTools ..
    1. 上下文通用协议(MCP):

    • 模型上下文协议(MCP)是一个开放协议,使LLM能够访问外部工具和数据源。
    • 这是高级功能,您可以访问此文档获取更多配置信息:Introduction - Model Context Protocol
    • Claude Code不仅支持接入MCP,同样支持作为MCP服务器等各类高级功能,您可以访问此文档获得更多信息:教程 - Anthropic
    1. 使用Git工作树运行并行Claude Code会话:

    • Claude Code 支持使用自然语言操作Git,如:
    > 提交我的更改 > 创建一个 pr > 哪个提交在去年十二月添加了 markdown 测试? > 在 main 分支上变基并解决任何合并冲突
    • 您可以使用工作树创建隔离的编码环境。
    • 如果您您需要同时处理多个任务,并在Claude Code实例之间完全隔离代码,您可以使用此功能:
      • Git工作树允许您从同一存储库中检出多个分支到单独的目录。每个工作树都有自己的工作目录,文件是隔离的,同时共享相同的Git历史。在官方Git工作树文档中了解更多。
      • 创建新工作树
          # 创建带有新分支的工作树 git worktree add ../project-feature-a -b feature-a # 或使用现有分支创建工作树 git worktree add ../project-bugfix bugfix-123
        • 这会创建一个包含存储库单独工作副本的新目录。
      • 在每个工作树中运行Claude Code
          # 导航到您的工作树 cd ../project-feature-a # 在这个隔离环境中运行Claude Code claude
      • 在另一个终端中:
          cd ../project-bugfix claude
      • 管理您的工作树
          # 列出所有工作树 git worktree list # 完成后移除工作树 git worktree remove ../project-feature-a
      • 每个工作树都有自己独立的文件状态,非常适合并行Claude Code会话
      • 在一个工作树中所做的更改不会影响其他工作树,防止Claude实例相互干扰
      • 所有工作树共享相同的Git历史和远程连接
      • 对于长时间运行的任务,您可以让Claude在一个工作树中工作,同时您在另一个工作树中继续开发
      • 使用描述性目录名称,以便轻松识别每个工作树的任务
      • 记得根据项目的设置在每个新工作树中初始化开发环境。根据您的技术栈,这可能包括:
        • JavaScript项目:运行依赖安装(npm installyarn
        • Python项目:设置虚拟环境或使用包管理器安装
        • 其他语言:遵循项目的标准设置流程
    1. 其他的自然语言功能:

    • 识别未文档化的代码
        > 在auth模块中查找没有适当JSDoc注释的函数
    • 生成文档
        > 为auth.js中未文档化的函数添加JSDoc注释
    • 理解陌生代码
        > 支付处理系统做什么? > 查找用户权限在哪里被检查 > 解释缓存层是如何工作的
    • 智能编辑代码
        > 为注册表单添加输入验证 > 重构日志记录器以使用新的 API > 修复工作队列中的竞态条件
    • 测试或编辑您的代码
    > 运行 auth 模块的测试并修复失败 > 查找并修复安全漏洞 > 解释为什么这个测试失败了
    1. 常见的斜杠命令:

      命令用途
      /bug报告错误(将对话发送给 Anthropic)
      /clear清除对话历史
      /compact [instructions]压缩对话,可选择焦点说明
      /config查看/修改配置
      /cost显示令牌使用统计
      /doctor检查 Claude Code 安装的健康状况
      /help获取使用帮助
      /init使用 CLAUDE.md 指南初始化项目
      /login切换 Anthropic 账户
      /logout从 Anthropic 账户登出
      /memory编辑 CLAUDE.md 记忆文件
      /pr_comments查看拉取请求评论
      /review请求代码审查
      /status查看账户和系统状态
      /terminal-setup安装 Shift+Enter 换行键绑定(仅限 iTerm2 和 VSCode)
      /vim进入 vim 模式以切换插入和命令模式
    1. 常用的快捷键:

    • 使用 # 快速记忆
      • 通过以 # 开始输入来即时添加记忆
    • 始终使用描述性变量名
      • 系统会提示你选择要将其存储在哪个记忆文件中。
    • 终端中的换行
      • 使用以下方式输入多行命令:
      • 快速转义:输入 \ 后按 Enter
      • 键盘快捷键:Option+Enter(或配置后的 Shift+Enter)
        • 在终端中设置 Option+Enter:
          • 对于 Mac Terminal.app
            • 打开设置 → 配置文件 → 键盘
            • 勾选”将 Option 键用作 Meta 键”
          • 对于 iTerm2 和 VSCode 终端:
            • 打开设置 → 配置文件 → 按键
            • 在常规设置下,将左/右 Option 键设置为”Esc+”
          • iTerm2 和 VSCode 用户提示:在 Claude Code 中运行 /terminal-setup 以自动配置 Shift+Enter 作为更直观的替代方案。
          • 有关配置详情,请参见官方文档:设置中的终端设置
    • Vim 模式
      • Claude Code 支持一部分 Vim 键绑定,可以通过 /vim 启用或通过 /config 配置。
      • 支持的功能包括:
        • 模式切换:Esc(到 NORMAL),i/Ia/Ao/O(到 INSERT)
        • 导航:h/j/k/lw/e/b0/$/^gg/G
        • 编辑:xdw/de/db/dd/Dcw/ce/cb/cc/C.(重复)
    1. 常见的报错:

    • 400 - invalid_request_error:您的请求格式或内容存在问题。我们也可能对下面未列出的其他 4XX 状态码使用此错误类型。
    • 401 - authentication_error:您的 API 密钥存在问题。
    • 403 - permission_error:您的 API 密钥没有使用指定资源的权限。
    • 404 - not_found_error:未找到请求的资源。
    • 413 - request_too_large:请求超过了允许的最大字节数。 建议使用/compact命令
    • 429 - rate_limit_error:您的账户达到了速率限制。
    • 500 - api_error:Anthropic 系统内部发生了意外错误。
    • 529 - overloaded_error:Anthropic 的 API 暂时过载。
    • 当 Anthropic API 在所有用户中遇到高流量时,可能会出现 529 错误。在极少数情况下,如果您的组织使用量急剧增加,您可能会看到此类错误。 为避免 529 错误,请逐步增加流量并保持一致的使用模式。
    当通过 SSE 接收流式响应时,可能在返回 200 响应后发生错误,在这种情况下错误处理不会遵循这些标准机制。
    1. 其他的高级功能: