🧑💻 一个在终端里为你写代码的 AI 编程助手
LangCode 是一个基于 LangChain + Deep Agents 构建的 Coding Agent，支持读写项目文件、执行 Shell 命令、跨会话记忆、人工审批等能力。一条命令安装，一条命令启动，在终端里拥有一个专属的 AI 编程助手。
- 📁 文件系统操作 — 读写、编辑、搜索项目文件，直接介入你的 workspace
- 🔧 Shell 命令执行 — 运行脚本、安装依赖、启动服务
- 🧠 跨会话记忆 — 记住你的技术栈偏好和项目上下文
- 📋 任务规划 — TodoList 机制，有条不紊地完成复杂任务
- 🔍 Skill 按需加载 — 不撑爆上下文窗口，需要时才加载领域知识
- 🛑 人工审批 — 关键操作（删除文件、执行危险命令）由你确认
- 🎨 终端 TUI — Claude Code 风格的交互界面，打字机效果 + 彩色输出
# 一条命令安装 LangCode
uv tool install --editable git+https://github.com/qwqzy/langcode.git
# 或者从本地安装
git clone https://github.com/qwqzy/langcode.git
cd langcode
uv tool install --editable .在项目根目录创建 .env 文件，配置你的模型信息：
# 使用 OpenRouter
OPENROUTER_API_KEY=sk-or-v1-xxx
OPENROUTER_MODEL=openai/gpt-oss-120b
# 或使用本地 Ollama
# OLLAMA_BASE_URL=http://localhost:11434/v1
# OLLAMA_MODEL=qwen3.5:4b# 在任何项目目录下执行
langcode$ langcode
╭──────────────────────────────╮
│ LangCode — 输入 /quit 退出 │
╰──────────────────────────────╯
> 帮我写一个 Python 爬虫，保存到 crawler/demo.py
🔧 调用工具: ls("/workspace/")
✅ 完成
🔧 调用工具: write_file("/workspace/crawler/demo.py", content="...")
✅ 完成
已创建 crawler/demo.py，包含一个基础的 HTTP 爬虫示例。langcode/
├── src/
│ └── langcode/
│ ├── __init__.py
│ ├── main.py # TUI 入口
│ ├── agent.py # Agent 构建逻辑
│ ├── backend.py # CompositeBackend 配置
│ ├── settings.py # 路径和用户配置
│ ├── memory/
│ │ └── short_memory.py # Checkpointer 配置
│ ├── middleware/ # 中间件组装
│ ├── prompt_builder/ # System Prompt
│ └── skills/ # 内置 Skill 定义
├── pyproject.toml
├── README.md
└── LICENSE
LangCode 是 《从文档战神到工具制造者》 博客系列的完整实现。博客记录了从手写 ReAct 循环到生产级 Agent 的全过程：
- 基础篇：手写 ReAct 循环，理解 Agent 本质
- 进阶篇：
create_agent+ 中间件工程化 - 高级篇：权限控制、
interrupt()、子代理、动态子代理 - 发布篇：
uv tool打包发布
如果你在阅读博客时遇到问题，欢迎查看对应章节的源码。
| 组件 | 技术 |
|---|---|
| Agent 框架 | LangChain 1.0+ |
| 执行引擎 | LangGraph 0.6+ |
| 文件系统 | Deep Agents Backend |
| 模型接口 | OpenRouter / Ollama |
| TUI | Rich + Prompt Toolkit |
| 打包工具 | uv |
欢迎 Issue 和 PR！
如果你有自己的模型想接入，或者想增加新的 Skill，欢迎提交代码。项目结构已经预留好了扩展点：
- 新增模型：修改
agent.py中的model配置 - 新增 Skill：在
skills/目录下添加SKILL.md - 新增中间件：在
middleware/中注册
MIT License © 2026 LangCode Contributors
- LangChain — 强大的 Agent 框架
- LangGraph — 状态图执行引擎
- Deep Agents — Agent 的“全家桶”实现
- Rich — 终端美化
- uv — 极速 Python 包管理
🧑💻 一条命令，开启你的 AI 编程之旅：
uvx langcode