aicodeguide

环境要求

• Node.js 与 npm 环境（用于全局安装 CLI 工具）
• 已安装 Claude Code CLI
• 注册 OpenRouter 账号并获取 API Key
• 一个支持配置的项目目录（用于放置 AGENTS.md 等规则文件）

安装与启动步骤

1. 1安装 Claude Code CLI

   用 npm 全局安装 Anthropic 官方命令行工具，作为后续接入任意 LLM 的基础客户端。

   npm install -g @anthropic-ai/claude-code

   复制

2. 2安装路由工具

   安装 claude-code-router，它会在本机启动代理，把 Claude Code 的请求转发到 OpenRouter 上的任意模型。

   npm install -g @musistudio/claude-code-router

   复制

3. 3写入路由配置

   编辑 ~/.claude-code-router/config.json，把 OPENROUTER_API_KEY 换成你自己的密钥，模型名可改为其他 OpenRouter 模型。

   {
     "Providers": [
       {
         "name": "kimi-k2",
         "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
         "api_key": "OPENROUTER_API_KEY",
         "models": [
           "moonshotai/kimi-k2"
         ],
         "transformer": {
           "use": ["openrouter"]
         }
       }
     ],
     "Router": {
       "default": "kimi-k2,moonshotai/kimi-k2"
     }
   }

   复制

4. 4通过路由启动

   执行 ccr code，Claude Code 会走本地代理；若显示本地 API Base URL 即接入成功。

   ccr code

   复制

5. 5配置项目规则

   在项目根目录建 AGENTS.md 写规则；Claude Code 用 CLAUDE.md 软链到 AGENTS.md，Cursor 放 .cursor/rules/。

关键配置

如何确认成功

运行 ccr code 后，看到 Claude Code 显示 API Base URL: http://127.0.0.1:3456，说明已通过本地代理接入。

常见问题

注意事项

• 本项目本质是一份 AI 编程学习指南（路线图），不是可运行的程序，安装步骤针对的是它推荐的 AI 编程工具链。
• README 未给出该指南自身的安装方式，上述命令均来自其「在 Claude Code 中使用任意 LLM」章节。
• API Key 属于敏感信息，不要写进仓库或提交到版本控制。
• 本地代理默认监听 127.0.0.1:3456，属于 claude-code-router 自身行为，无需手动配置端口。