claude-codex-settings

一套配置,让 Claude/Codex/Cursor 用上国产大模型

这是一个为 Claude Code、OpenAI Codex、Cursor 等 AI 编程工具提供配置、插件、钩子和代理的集合,并支持接入 Kimi、MiniMax、GLM 等国产大模型 API。项目旨在解决 AI 编程工具配置繁琐、模型选择受限的问题,通过预置的实战测试配置和插件,让开发者能快速启用更强大或更经济的模型,并扩展工具的功能边界。核心能力包括:统一管理多工具的配置、提供可复用的插件和钩子、支持自定义模型接入,以及持续更新的社区维护配置库。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1152
维护状态 活跃
是否开源
定价模式 unknown

项目数据

分类智能体
开发团队fcakyon
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源
开源协议Apache-2.0
主要语言Python
技术栈/模型ai-agents,ai-tools,claude-ai,claude-code,claude-code-plugin,claude-skills,claudecode,claudecode-config,codex,codex-cli,commit-message,cursor,dokploy,frontend-design,gemini-cli,github,hetzner,kimi-k3,plugin,pull-requests
GitHub 星标★ 1152
30天Star增速
HF 下载量
上线时间2025-07-09 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数6

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 8 步

环境要求

  • 已安装 Claude Code CLI 或 Claude Desktop(安装 Claude 系列插件时需要)
  • 按需安装 OpenAI Codex CLI、Gemini CLI 或 Cursor
  • 使用 Kimi / MiniMax / Z.ai GLM 等国产模型时,需先在对应平台申请 API Key
  • 前置依赖细节需查看仓库根目录的 INSTALL.md

安装与启动步骤

  1. 1添加插件市场

    在 Claude Code 中一次性添加本仓库作为插件市场来源,之后才能按名称安装其中的插件。

    claude plugin marketplace add fcakyon/claude-codex-settings
  2. 2安装 Claude 插件

    按名称安装所需插件,示例安装 fable-advisor。README 说明只装自己需要的即可。

    claude plugin install fable-advisor@claude-settings
  3. 3桌面端添加插件

    Claude Code 桌面端可不用命令行:在输入框旁点 + ,选择 Plugins,再点 Add plugin。

  4. 4Codex 安装插件

    Codex CLI 用 plugin add 按名称安装,示例安装 simplify;桌面应用则在 Plugins 中选 Install。

    codex plugin add simplify@claude-settings
  5. 5Gemini 安装扩展

    Gemini CLI 通过 extensions install 并指定本地路径安装插件,示例为 simplify 插件目录。

    gemini extensions install --path ./plugins/simplify
  6. 6配置 Kimi K3

    导出环境变量,把 Claude Code 指向 Moonshot 的 Anthropic 兼容接口,密钥换成自己的。

    export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
    export ANTHROPIC_AUTH_TOKEN="your-moonshot-api-key"
    export ANTHROPIC_MODEL="kimi-k3[1m]"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3[1m]"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.7-code"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"
    export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3[1m]"
    export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3[1m]"
    export ENABLE_TOOL_SEARCH=false
  7. 7配置 MiniMax M3

    同样的方式接入 MiniMax 的 Anthropic 兼容接口,[1m] 解锁 1M 上下文窗口。

    export ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
    export ANTHROPIC_AUTH_TOKEN="your-minimax-api-key"
    export ANTHROPIC_MODEL=MiniMax-M3[1m]
    export ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M3[1m]
    export ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M3[1m]
    export ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.7-highspeed
    export CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000
    export ENABLE_TOOL_SEARCH=false
  8. 8配置 Codex

    Codex 的模型、沙箱与审批策略写在 ~/.codex/config.toml 中,仓库提供了示例文件可直接参考。

关键配置

配置项必填说明示例
ANTHROPIC_BASE_URL把 Claude Code 的请求指向第三方模型接口地址https://api.moonshot.ai/anthropic
ANTHROPIC_AUTH_TOKEN第三方模型平台的 API 密钥your-moonshot-api-key
ANTHROPIC_MODEL指定 Claude Code 使用的主模型kimi-k3[1m]
ANTHROPIC_DEFAULT_SONNET_MODEL替换默认 Sonnet 档位模型,通常用便宜快模型kimi-k2.7-code
ENABLE_TOOL_SEARCH接入 Kimi/MiniMax 时设为 false 关闭工具搜索false
CLAUDE_CODE_AUTO_COMPACT_WINDOWMiniMax 配置中控制自动压缩的上下文窗口大小400000

如何确认成功

执行 claude auto-mode defaults,可打印当前内置 auto mode 配置块与 allow 规则,确认 Claude Code 已正确读取配置。

常见问题

Q:安装前需要准备什么?

A:README 指向仓库根目录的 INSTALL.md 查看前置要求,请先按该文档准备好对应工具与本项目的依赖。

Q:如何只接入国产模型不装插件?

A:可以,插件与模型配置相互独立。要么按 README 的 export 命令注入环境变量,要么直接使用仓库中的 .claude/settings-kimi.json、settings-minimax.json、settings-zai.json。

Q:Codex 上用 MiniMax 为什么要代理?

A:因为 MiniMax 只暴露 chat completions 接口,而 Codex 需要 Responses API,所以 README 要求走本地 Responses 代理;Z.ai 自带 /api/v1 端点则无需代理。

Q:Kimi 的 256K 上下文怎么开?

A:在代理命令和 Codex 配置中同时把模型 ID 换成 k3-256k 即可,默认的 k3 使用更长上下文。

Q:API Key 从哪里获取?

A:Kimi 在 platform.moonshot.ai,MiniMax 在 minimax.io,Z.ai GLM 在 z.ai/model-api,注册后即可生成密钥。

注意事项

  • README 建议只安装自己需要的插件,不必全量安装。
  • 前置环境要求以仓库根目录的 INSTALL.md 为准,本文未展开。
  • export 的环境变量只在当前终端会话生效,换终端需重新设置或写入配置文件。
  • Codex 上接入 Kimi 需使用本地 Responses 代理,接入 MiniMax 同样需要本地代理。

核心亮点

  • 预置多种实战验证的配置,开箱即用,省去调参时间
  • 支持 Kimi、MiniMax、GLM 等国产模型,降低 API 成本
  • 统一管理 Claude Code、Codex、Cursor 多工具配置,方便迁移

不足之处

  • 配置和插件依赖具体工具版本,升级可能需手动适配
  • 文档/社区待观察

适用场景

  • 想用国产大模型替代 OpenAI 或 Anthropic 的开发者
  • 需要统一管理多个 AI 编程工具配置的团队
  • 希望扩展 Claude Code 或 Codex 功能的进阶用户

替代项目

dotfiles、awesome-claude-code、claude-code-templates

项目介绍

claude-codex-settings 是编程开发领域的开源项目,由 fcakyon 开发,2025 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,152)位列前 30%,在编程开发分类中处于中上游。

近 45 天,它的 GitHub 星标从 1,022 增加到 1,152,净增 130。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。从国内网络环境看,可直接访问。

它主要面向的使用场景是:想用国产大模型替代OpenAI或Anthropic的开发者。同类可对比的替代方案包括 dotfiles、awesome-claude-code、claude-code-templates。

上一篇:remote_compilation_helper

下一篇:cctop

同类项目推荐

bolt.new 开源

想到啥说啥,网页应用当场生成直接能用

Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···

★ 16557 2026-08-09
fuzz4all 开源

用大模型自动生成测试输入,发现各种软件漏洞

️Fuzz4All: Universal Fuzzing with Large Language Models

★ 338 2026-08-09
superpowers-zh 开源

全套 AI 编程神技汉化好了,照着用就行。

AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···

★ 8188 2026-08-09
Gitea 代码托管 开源

轻量 Git 代码托管平台

Git with a cup of tea! Painless self-hosted all-in-one software development service,···

★ 58115 2026-08-22