mirror of
https://github.com/anomalyco/opencode.git
synced 2026-11-19 00:03:13 +03:00
docs(console): set up harnesses with the Console CLI (#64459)
This commit is contained in:
@@ -7,6 +7,12 @@ Claude Code speaks the Anthropic Messages API. Point it at Console with two envi
|
||||
model, including GPT, Gemini, and open models. Console translates the request for models that don't accept Anthropic
|
||||
Messages.
|
||||
|
||||
<Callout>
|
||||
The [Console CLI](/console/harnesses#console-cli) sets up Claude Code with one command, including the workspace's
|
||||
policies, MCP servers, skills and instructions. Run `npx @opencode/console setup claude-code`. The steps below set it
|
||||
up by hand.
|
||||
</Callout>
|
||||
|
||||
```bash
|
||||
export ANTHROPIC_BASE_URL="https://opencode.ai/inference/anthropic"
|
||||
export ANTHROPIC_AUTH_TOKEN="oc_sk_..."
|
||||
|
||||
@@ -6,6 +6,11 @@ description: "Use Console and Go models from Codex."
|
||||
Codex speaks the OpenAI Responses API. Point it at Console and use any paid or Go model, including Claude, Gemini, and
|
||||
open models. Console translates the request for models that don't accept Responses.
|
||||
|
||||
<Callout>
|
||||
The [Console CLI](/console/harnesses#console-cli) sets up Codex with one command, including the workspace's policies,
|
||||
MCP servers, skills and instructions. Run `npx @opencode/console setup codex`. The steps below set it up by hand.
|
||||
</Callout>
|
||||
|
||||
## Configure
|
||||
|
||||
Add Console as a model provider in `~/.codex/config.toml` and make it the default.
|
||||
|
||||
@@ -6,6 +6,11 @@ description: "Use Console and Go models from Hermes Agent."
|
||||
[Hermes Agent](https://hermes-agent.nousresearch.com) includes OpenCode providers for pay-as-you-go and Go. It picks the
|
||||
right API for each paid or Go model. Free-tier chat models require OpenCode and return HTTP `403` from Hermes.
|
||||
|
||||
<Callout>
|
||||
The [Console CLI](/console/harnesses#console-cli) sets up Hermes with one command, including the workspace's policies,
|
||||
MCP servers, skills and instructions. Run `npx @opencode/console setup hermes`. The steps below set it up by hand.
|
||||
</Callout>
|
||||
|
||||
| Provider | Plan | Key variable |
|
||||
| -------------- | ------------- | ---------------------- |
|
||||
| `opencode-zen` | Pay-as-you-go | `OPENCODE_ZEN_API_KEY` |
|
||||
|
||||
@@ -17,6 +17,36 @@ paid or Go model, and usage is billed to your workspace like any other request.
|
||||
Free-tier chat models are only available from within OpenCode. Other harnesses receive HTTP `403` for those models,
|
||||
even with a Console API key. Use paid models or a Go subscription.
|
||||
|
||||
## Console CLI
|
||||
|
||||
The [Console CLI](https://github.com/anomalyco/opencode-console-cli) connects a harness to your workspace with one
|
||||
command. It needs Node.js 22 or later.
|
||||
|
||||
| Harness | Command |
|
||||
| ---------------- | ---------------------------------------------- |
|
||||
| Claude Code | `npx @opencode/console setup claude-code` |
|
||||
| Codex | `npx @opencode/console setup codex` |
|
||||
| Hermes | `npx @opencode/console setup hermes` |
|
||||
| Pi | `npx @opencode/console setup pi` |
|
||||
| DeepSeek Harness | `npx @opencode/console setup deepseek-harness` |
|
||||
|
||||
Your browser opens Console, where you approve the sign-in and pick the workspace. The harness then gets
|
||||
|
||||
- the workspace's models, through Console
|
||||
- the workspace's policies, checked before every tool call
|
||||
- the workspace's MCP servers, skills and instructions
|
||||
|
||||
The CLI keeps the harness in sync with the workspace and updates itself.
|
||||
|
||||
To keep a harness's own sign-in and models, such as a Claude or ChatGPT subscription, add `--keep-provider`. The harness
|
||||
still gets the workspace's policies, MCP servers, skills and instructions. It works with Claude Code, Codex and Hermes.
|
||||
|
||||
```bash
|
||||
npx @opencode/console setup codex --keep-provider
|
||||
```
|
||||
|
||||
To set up a harness by hand, or one the CLI doesn't cover, use an API key and the base URLs below.
|
||||
|
||||
## Get an API key
|
||||
|
||||
Harnesses authenticate with a Console API key. The quickest option is a
|
||||
|
||||
@@ -6,6 +6,11 @@ description: "Use Console and Go models from the Pi coding agent."
|
||||
[Pi](https://pi.dev) includes OpenCode providers for pay-as-you-go and Go. It picks the right API for each paid or Go
|
||||
model. Free-tier chat models require OpenCode and return HTTP `403` from Pi.
|
||||
|
||||
<Callout>
|
||||
The [Console CLI](/console/harnesses#console-cli) sets up Pi with one command, including the workspace's policies, MCP
|
||||
servers, skills and instructions. Run `npx @opencode/console setup pi`. The steps below set it up by hand.
|
||||
</Callout>
|
||||
|
||||
| Provider | Plan |
|
||||
| ------------- | ------------- |
|
||||
| `opencode` | Pay-as-you-go |
|
||||
|
||||
Reference in New Issue
Block a user